Tfnsw Realtime Alerts MCP Server

🚀 新南威尔士州实时警报 MCP 服务器

这是一个模型上下文协议（Model Context Protocol）服务器，专为 Transport for NSW（TfNSW）的实时警报 API 打造。它提供了一系列工具，能让用户访问并交互获取实时交通警报和信息，还借助大型语言模型来实现相关功能。

🚀 快速开始

此基于 TypeScript 的语言服务器实现了与新南威尔士州运输局实时警报系统的集成。借助它，AI 助手可以访问最新的交通中断、计划中的工程以及其他重要的交通网络警报信息。

✨ 主要特性

资源

• 可列出并通过 nsw-transport:// URI 访问交通警报。
• 支持按交通方式过滤警报，如公交、火车、渡轮等。
• 以纯文本格式输出，方便 AI 助手使用。

工具

• get-transport-alerts：用于获取当前的运输警报。
  • 支持按交通方式过滤。
  • 返回格式化的警报信息，涵盖受影响路线、时间范围和影响细节。

提示

• transport-disruption-summary：用于生成当前交通警报的摘要。
  • 包含相关警报详细信息作为嵌入资源。
  • 返回结构化提示，供大语言模型（LLM）总结主要中断情况。

🚌 交通方式

本服务器支持以下交通方式：

• all：所有交通方式
• buses：悉尼地铁和外围地铁公交服务
• ferries：悉尼渡轮和纽卡斯尔运输渡轮
• lightrail：轻轨服务
• metro：悉尼地铁
• nswtrains：NSW 火车区域列车和客车
• 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 开放数据平台 获取的 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，详细信息请参阅 LICENSE 文件。