TfNSW 实时警报 MCP 服务器

这是一个用于新南威尔士州交通局 (TfNSW) 实时警报 API 的模型上下文协议 (MCP) 服务器。该服务器提供了通过大型语言模型访问和交互实时交通警报和信息的工具。

概述

这个基于 TypeScript 的 MCP 服务器实现了与新南威尔士州交通局实时警报系统的集成。它使 AI 助手能够获取有关新南威尔士州交通网络中的交通中断、计划工作和其他重要警报的最新信息。

功能

资源

• 通过 nsw-transport:// URI 列出和访问交通警报
• 按交通方式（公交车、火车、渡轮等）筛选警报
• 以纯文本格式提供，便于 AI 助手处理

工具

• get-transport-alerts - 获取当前交通警报
  • 按交通方式筛选
  • 返回格式化的警报信息，包括受影响的路线、时间段和影响详情

提示

• transport-disruption-summary - 生成当前交通警报的摘要
  • 包含相关警报细节作为嵌入资源
  • 返回结构化的提示，供大型语言模型对主要中断进行总结

交通方式

支持以下交通方式：

• all - 所有交通方式
• buses - 悉尼市区及郊区公交服务
• ferries - 悉尼渡轮和纽卡斯尔运输渡轮
• lightrail - 轻轨服务
• metro - 悉尼地铁
• nswtrains - 新南威尔士州区域火车和长途汽车
• regionbuses - 区域公交服务
• sydneytrains - 悉尼市郊和城际铁路网

认证

此服务器需要使用 TfNSW 开放数据 API 进行认证。您需要在 TfNSW 开放数据中心 注册一个 API 密钥。

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tfnsw-realtime-alerts": {
      "command": "npx",
      "args": [
        "-y",
        "tfnsw-realtime-alerts-mcp-server"
      ],
      "env": {
        "NSW_TRANSPORT_API_KEY": "your_api_key_here"
      }
    }
  }
}

将 "your_api_key_here" 替换为您从 TfNSW 开放数据中心 获取的 TfNSW API 密钥。

开发

在您的 .env 文件中将您的 API 密钥配置为环境变量：

NSW_TRANSPORT_API_KEY="your_api_key_here"

安装依赖项：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

调试

您可以使用 MCP Inspector 进行调试，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL，以便您在浏览器中访问调试工具。

许可

该项目根据 MIT 许可证许可 - 详情请参阅 LICENSE 文件。