TfNSW 实时警报 MCP 服务器

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

概述

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

功能

资源

• 通过 nsw-transport:// URI 列出和访问交通警报
• 按交通方式（公共汽车、火车、渡轮等）过滤警报
• 纯文本格式，方便 AI 助手使用

工具

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

提示

• transport-disruption-summary - 生成当前交通警报的摘要
  • 包括相关的警报详情作为嵌入资源
  • 返回结构化的提示，供 LLM 总结主要的交通中断

交通方式

支持以下交通方式：

• 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 文件。