MCP Server Public Transport

🚀 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，你可以通過它檢索火車車次、即時出發信息和公交車位置。

支持的國家

各國支持的功能

📦 安裝指南

開發環境搭建

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 進行測試，可使用以下命令：

# 運行所有測試
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許可證