London Tfl Journey Status MCP Server

🚀 倫敦交通局（TfL）狀態與行程規劃MCP服務器

本 模型上下文協議（MCP） 服務器通過一系列自動化工具，為AI助手提供對倫敦交通局即時數據的訪問權限。

⚠️ 重要免責聲明

這 並非倫敦交通局（TfL）官方的MCP服務器。這是一個獨立項目，它使用公開可用的 TfL統一API 來提供交通數據。它與倫敦交通局沒有關聯，未得到其認可，也未獲得其官方支持。

🎥 演示視頻

🚇 此MCP服務器的功能

該服務器通過提供三項主要功能，使AI助手（如Claude Desktop和VS Code GitHub Copilot）能夠訪問即時的TfL數據：

🔧 可用工具

1. get_line_status - 獲取任意TfL線路（如中央線、維多利亞線、皮卡迪利線）的當前狀態。
2. get_line_status_detail - 獲取TfL線路的詳細狀態信息，包括服務中斷詳情。
3. plan_journey - 使用TfL行程規劃器規劃兩個地點之間的行程。

🎯 使用場景

連接此MCP服務器後，AI助手可以幫助用戶：

• 在通勤前檢查地鐵線路是否正常運行。
• 獲取服務中斷的詳細信息。
• 規劃倫敦各地點之間的最佳路線。
• 為倫敦出行提供即時交通建議。

示例交互：

• “中央線運行正常嗎？”
• “規劃從國王十字車站到希思羅機場的行程。”
• “今天北線延誤的原因是什麼？”

讓我們開始設置吧！

🚦 快速開始

選擇你偏好的安裝方法：

📦 選項1：通過npm快速安裝（推薦）

使用此MCP服務器最簡單的方法是通過npm：

安裝

npm install -g london-transport-mcp

🔐 設置你的TfL API密鑰

你可以從 TfL API門戶 獲取免費的API密鑰。

方法1：環境變量（推薦） 在系統中設置環境變量：

# Windows（PowerShell）
$env:TFL_API_KEY="your_actual_tfl_api_key_here"

# macOS/Linux
export TFL_API_KEY="your_actual_tfl_api_key_here"

方法2：MCP配置 直接在MCP配置中包含API密鑰（見以下示例）。

AI助手配置

對於Claude Desktop（設置 → 開發者 → 編輯配置）：

{
  "mcpServers": {
    "london-transport": {
      "command": "npx",
      "args": ["london-transport-mcp"],
      "env": {
        "TFL_API_KEY": "your_actual_tfl_api_key_here"
      }
    }
  }
}

對於VS Code GitHub Copilot（設置 → GitHub Copilot › MCP：服務器）：

{
  "london-transport": {
    "command": "npx",
    "args": ["london-transport-mcp"],
    "env": {
      "TFL_API_KEY": "your_actual_tfl_api_key_here"
    }
  }
}

就是這樣！無需手動安裝或配置路徑。

🛠️ 選項2：本地開發設置

對於想要修改代碼或做出貢獻的開發者：

⚙️ 前提條件

在開始之前，請確保你具備以下條件：

• Node.js（需要v18+，推薦v20+）
• npm（包含在Node中）

警告：如果你使用較低版本的Node運行，將無法使用fetch。工具使用fetch進行HTTP調用。要解決這個問題，你可以修改工具以使用node-fetch代替。確保將node-fetch作為依賴項安裝，然後在每個工具文件中將其作為fetch導入。

📥 安裝與設置

1. 克隆倉庫

git clone https://github.com/anoopt/london-tfl-journey-status-mcp-server.git
cd london-tfl-journey-status-mcp-server

2. 安裝依賴項

npm install

🔐 設置你的TfL API密鑰

3. 配置你的TfL API密鑰 在項目根目錄下創建一個.env文件，並添加你的TfL API密鑰：

TFL_API_KEY=your_actual_tfl_api_key_here

你可以從 TfL API門戶 獲取免費的API密鑰。

🧪 使用Postman測試MCP服務器

我們強烈建議在將MCP服務器連接到AI助手之前，使用Postman對其進行測試。 Postman桌面應用程序提供了運行和測試MCP服務器的最簡單方法。

步驟1：下載Postman桌面應用程序

從 postman.com/downloads 下載最新的Postman桌面應用程序。

步驟2：創建MCP請求

1. 打開Postman桌面應用程序。
2. 創建一個新的 MCP請求（詳細步驟請參閱 文檔）。
3. 將類型設置為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為為