TfNSW Realtime Alerts MCP Server

TfNSW Realtime Alerts MCP Server

site icon
2025.05.09 0
JavaScript实时交通警报交通信息集成位置服务
TfNSW Realtime Alerts MCP Server 是一个基于 Model Context Protocol 的服务器,用于访问和交互 Transport for NSW (TfNSW) 的实时交通警报和信息。该服务器通过大型语言模型提供工具,帮助用户获取最新的交通中断、计划工程和其他重要警报信息。
View on GitHub

Overview

基本能力

产品定位

TfNSW Realtime Alerts MCP Server 是一个用于实时交通警报和信息的集成服务器,旨在通过 AI 助手提供最新的交通中断和计划工程信息。

核心功能

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

  5. 工具

  6. get-transport-alerts:检索当前交通警报,支持按交通模式过滤,返回格式化的警报信息,包括受影响的路线、时间段和影响详情。

  7. 提示

  8. transport-disruption-summary:生成当前交通警报的摘要,包括相关警报细节作为嵌入式资源,返回用于 LLM 摘要的结构化提示。

适用场景

  1. 实时交通中断信息的获取和摘要生成。
  2. 交通警报的过滤和分类。
  3. AI 助手集成,提供最新的交通信息。

使用教程

使用依赖

  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

配置示例: 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 密钥。

  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 Inspector 将提供一个 URL,用于在浏览器中访问调试工具。

许可证

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