TfNSW Realtime Alerts MCP Server

TfNSW 实时提醒 MCP 服务

这是一个用于 Transport for NSW（TfNSW）实时提醒 API 的模型上下文协议服务。此服务提供工具，让大模型能够访问实时交通提醒和信息并与之交互。

概述

此 TypeScript MCP 服务实现了与 Transport for NSW 实时提醒系统的集成。它使 AI 助手能够获取有关 NSW 交通网络中交通中断、计划施工及其他重要提醒的最新信息。

功能

资源

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

工具

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

提示词

• transport-disruption-summary - 生成当前交通提醒摘要
  • 将相关提醒详情作为嵌入式资源
  • 返回结构化提示词，用于让大模型总结重大交通中断

交通方式

支持以下交通方式：

• all - 所有交通方式
• buses - Sydney Metro 和 Outer Metro 公交服务
• ferries - Sydney Ferries 和 Newcastle Transport 渡轮
• lightrail - 轻轨服务
• metro - Sydney Metro
• nswtrains - NSW Trains 区域列车和长途汽车
• regionbuses - 区域公交服务
• sydneytrains - Sydney Trains 市郊及城际网络

身份验证

此服务需要通过 TfNSW Open Data API 进行身份验证。你需要在 TfNSW Open Data Hub 注册以获取 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 Open Data Hub 获取的 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 文件。