🚀 mcp-server-public-transport
这是一个兼容MCP的服务器，可提供全欧洲的实时公共交通数据。借助该服务器，用户能够轻松获取欧洲各地的公共交通信息，极大提升出行规划的便利性。
🚀 快速开始
环境变量
设置以下环境变量：
UK_TRANSPORT_APP_ID=your_uk_app_id
UK_TRANSPORT_API_KEY=your_uk_api_key
在Claude Desktop中使用
添加到 claude_desktop_config.json 文件：
{
"mcpServers": {
"mcp-server-public-transport": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-server-public-transport",
"run",
"server.py"
],
"env": {
"UK_TRANSPORT_APP_ID": "your-uk-app-id",
"UK_TRANSPORT_API_KEY": "your-uk-api-key"
}
}
}
}
请将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-public-transport 替换为你克隆仓库的实际路径。
⚠️ 重要提示
你可能需要在
command字段中填写uv可执行文件的完整路径。在MacOS/Linux系统中可通过运行which uv获取，在Windows系统中可通过运行where uv获取。
✨ 主要特性
mcp-server-public-transport 是一个兼容 模型上下文协议（MCP） 的本地服务器，可让你访问全欧洲的公共交通数据。目前，它集成了英国、瑞士和比利时的API，你可以通过它检索火车车次、实时出发信息和公交车位置。
支持的国家
| 国家 | API基础URL | 状态 |
|---|---|---|
| 英国 | https://transportapi.com | ✅ |
| 瑞士 | https://transport.opendata.ch | ✅ |
| 比利时 | https://api.irail.be | ✅ |
各国支持的功能
| 功能 | API路径 | 状态 |
|---|---|---|
| 英国 | ||
| 实时出发信息 | /uk/train/station_timetables/{station_code}.json |
✅ |
| 瑞士 | ||
| 搜索车次 | /connections |
✅ |
| 车站查询 | /locations |
✅ |
| 出发信息板 | /stationboard |
✅ |
| 附近车站 | /locations?x={lon}&y={lat} |
✅ |
| 比利时 | ||
| 实时出发信息 | /departures |
✅ |
| 车站查询 | /stations |
✅ |
| 附近车站 | /stations/nearby |
✅ |
📦 安装指南
开发环境搭建
- 克隆仓库
git clone https://github.com/mirodn/mcp-server-public-transport.git
cd mcp-server-public-transport
- 安装依赖
uv sync
- 设置环境变量
cp .env.example .env
- 运行服务器
uv run server.py
运行测试
项目使用 pytest 进行测试，可使用以下命令：
# 运行所有测试
make test
代码质量
# 运行代码检查
make lint
# 运行代码格式化
make format
持续集成
项目包含一个GitHub Actions工作流（.github/workflows/test.yml），它会自动执行以下操作：
- 在Python 3.10、3.11和3.12版本上运行测试
- 使用
ruff执行代码检查 - 在每次推送到
main分支或发起拉取请求时运行
CI管道可确保在合并任何更改之前，代码质量和兼容性都能满足要求。
🤝 贡献代码
欢迎贡献代码！请随时提交拉取请求。当 pyproject.toml 中的 project.version 更新时，该包会自动部署到PyPI。请遵循语义化版本控制规范进行版本管理。
📄 许可证
MIT许可证