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. 将类型设置为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为为