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桌面一起使用，请添加服务器配置：

在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文件以获取详细信息。