Metro MCP

🚀 Metro MCP

Metro MCP 是一個遠程模型上下文協議（MCP）服務器，它與華盛頓特區地鐵（WMATA）的 API 進行對接。該項目專為與像 Claude Desktop 這樣支持 MCP 的客戶端集成而構建，並且配置為可部署在 Cloudflare Workers 上。

✨ 主要特性

你可以使用自然語言詢問有關地鐵的問題：

即時交通信息

• 查詢列車到站時間：例如“杜邦環島站的下一班紅線列車什麼時候到？”
• 獲取服務警報：如“藍線現在有延誤情況嗎？”
• 查找電梯/自動扶梯故障信息：像“聯合車站的所有電梯都正常運行嗎？”

車站信息與導航

• 搜索車站：例如“史密森尼地鐵站在哪裡？”
• 按線路查找車站：如“顯示綠線上的所有車站”

行程規劃與無障礙設施查詢

• 路線規劃：例如“我如何從國會山南站前往貝塞斯達？”
• 檢查無障礙設施情況：如“從這裡到國家機場之間有電梯故障嗎？”
• 即時預測：像“畫廊廣場站接下來的三趟列車分別是什麼時候到？”

服務監控

• 當前事故情況：例如“現在地鐵有延誤情況嗎？”
• 特定線路問題：如“橙線運行正常嗎？”
• 施工更新：像“哪些車站因施工而關閉？”

地理與系統信息

• 獲取所有車站信息：可獲取包含所有地鐵站座標的完整列表
• 線路信息：可瞭解所有六條地鐵線路的詳細信息

📦 安裝指南

克隆此倉庫，填入你自己的環境變量，然後部署服務器，最後配置你的 MCP 客戶端。

環境變量

將 wrangler.toml.example 複製為 wrangler.toml，並設置你的環境變量：

[vars]
WMATA_API_KEY = "your-wmata-api-key"           # 必需 - 從 developer.wmata.com 獲取
JWT_SECRET = "your-jwt-secret"                 # 必需 - 使用以下命令生成：openssl rand -hex 32
GITHUB_CLIENT_ID = "your-github-client-id"     # 可選 - OAuth 應用客戶端 ID
GITHUB_CLIENT_SECRET = "your-github-secret"    # 可選 - OAuth 應用客戶端密鑰
OAUTH_REDIRECT_URI = "https://your-domain.com/callback"  # 可選 - 你的回調 URL

OAuth 設置（可選）

若要要求用戶登錄後才能訪問你的服務器，可以使用像 GitHub 這樣的 OAuth 提供商來設置身份驗證。

對於 GitHub OAuth 身份驗證：

1. 在 github.com/settings/developers 創建一個 GitHub OAuth 應用。
2. 將授權回調 URL 設置為 https://your-domain.com/callback。
3. 使用你的 OAuth 憑證設置上述環境變量。

Claude Desktop 集成

將以下內容添加到你的 Claude Desktop MCP 配置中：

{
  "mcpServers": {
    "metro-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-domain.com/sse",
        "--header",
        "Authorization: Bearer your-token-here"
      ]
    }
  }
}

📚 詳細文檔

MCP 服務器與官方 WMATA API 進行對接。如需詳細信息，請訪問 WMATA 的開發者文檔。

• 車站預測：提供即時列車到站信息
• 車站信息：包含車站名稱、代碼和位置
• 事故信息：提供服務中斷和相關通知
• 電梯/自動扶梯故障信息：提供無障礙設施相關信息

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。