mcp-server-public-transport

一个提供欧洲实时公共交通数据的 MCP 服务器。

关于

mcp-server-public-transport 是一个兼容 Model Context Protocol (MCP) 的本地服务器，提供对欧洲各地公共交通数据的访问。 目前，它集成了英国、瑞士、挪威、比利时以及柏林/勃兰登堡地区的 API，允许您检索火车连接、实时出发信息和公交车位置。

Related MCP server: Berlin Transport MCP Server

功能实现状态

支持的国家/地区

各国功能

设置

环境变量

设置以下环境变量：

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 替换为您克隆存储库的实际路径。

注意：您可能需要在命令字段中填写 uv 可执行文件的完整路径。您可以通过在 MacOS/Linux 上运行 which uv 或在 Windows 上运行 where uv 来获取该路径。

开发

设置开发环境

1. 克隆存储库

   git clone https://github.com/mirodn/mcp-server-public-transport.git
   cd mcp-server-public-transport

2. 安装依赖

   uv sync

3. 设置环境变量

   cp .env.example .env

4. 运行服务器

   uv run server.py

运行测试

该项目使用 pytest 进行测试，可使用以下命令：

# Run all tests
make test

代码质量

# Run linting
make lint

# Run code formatting
make format

持续集成

该项目包含一个 GitHub Actions 工作流 (.github/workflows/test.yml)，它会自动：

• 在 Python 3.10、3.11 和 3.12 上运行测试

• 使用 ruff 执行代码检查

• 在每次推送到 main 分支或提交拉取请求时运行

CI 流水线确保在合并任何更改之前，代码在支持的 Python 版本中保持高质量和兼容性。

贡献

欢迎贡献！请随时提交拉取请求 (Pull Request)。

当 pyproject.toml 中的 project.version 更新时，该包会自动部署到 PyPI。 版本控制请遵循 semver 规范。

许可证

MIT 许可证