TfNSW Realtime Alerts MCP Server

TfNSW Realtime Alerts MCP Server

site icon
2025.03.09 6
JavaScript交通警报服务实时数据服务位置服务
TfNSW Realtime Alerts MCP Server 是一个基于 TypeScript 的 Model Context Protocol 服务器,用于与 Transport for NSW 的实时警报系统集成。该服务器使 AI 助手能够访问新南威尔士州交通网络中关于交通中断、计划工程和其他重要警报的最新信息。
View on GitHub

Overview

基本能力

产品定位

TfNSW Realtime Alerts MCP Server 是一个用于访问和交互新南威尔士州交通实时警报的 MCP 服务器,主要服务于 AI 助手和开发者。

核心功能

  1. 资源访问
  2. 通过 nsw-transport:// URI 列出和访问交通警报
  3. 按交通模式(公交车、火车、渡轮等)过滤警报
  4. 提供纯文本格式,便于 AI 助手使用

  5. 工具

  6. get-transport-alerts:检索当前交通警报

    • 可按交通模式过滤
    • 返回格式化的警报信息,包括受影响路线、时间段和影响详情
  7. 提示

  8. transport-disruption-summary:生成当前交通警报的摘要
    • 包含相关警报详情作为嵌入资源
    • 返回结构化提示,用于 LLM 对主要中断的总结

适用场景

  1. AI 助手需要提供实时交通警报信息
  2. 开发者需要集成新南威尔士州交通实时警报系统
  3. 需要按交通模式过滤和获取特定警报的应用

使用教程

使用依赖

  1. 需要注册 TfNSW Open Data API 的 API 密钥,可在 TfNSW Open Data Hub 获取。

安装教程

  1. 在 Claude Desktop 中添加服务器配置:
  2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

配置内容如下(替换 your_api_key_here 为你的 API 密钥): json { "mcpServers": { "tfnsw-realtime-alerts": { "command": "npx", "args": [ "-y", "tfnsw-realtime-alerts-mcp-server" ], "env": { "NSW_TRANSPORT_API_KEY": "your_api_key_here" } } } }

  1. 开发环境设置:
  2. .env 文件中配置 API 密钥: NSW_TRANSPORT_API_KEY="your_api_key_here"
  3. 安装依赖: bash npm install
  4. 构建服务器: bash npm run build
  5. 开发时自动重建: bash npm run watch

调试方式

  1. 使用 MCP Inspector 进行调试: bash npm run inspector
  2. Inspector 将提供一个 URL 用于在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。