实时交通警报服务器

一个基于TypeScript的MCP服务器,用于访问和交互新南威尔士州交通局的实时交通警报和信息,支持多种交通模式。

  • by piddlingtuna
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 piddlingtuna/tfnsw-realtime-alerts-mcp-server

使用说明

新南威尔士州交通局实时警报MCP服务器

用于新南威尔士州交通局(TfNSW)实时警报API的模型上下文协议服务器。该服务器提供了通过大型语言模型访问实时交通警报和信息并与之交互的工具。

概述

这个基于TypeScript的MCP服务器实现了与新南威尔士州交通部实时警报系统的集成。它使人工智能助手能够访问新南威尔士州交通网络中有关交通中断、计划工程和其他重要警报的最新信息。

特性

资源

  • 通过以下方式列出和访问运输警报 nsw-transport:// URI
  • 按交通方式(公共汽车、火车、渡轮等)过滤警报
  • 纯文本格式,便于人工智能助手使用

工具

  • get-transport-alerts -检索当前运输警报
    • 按运输方式筛选
    • 返回格式化的警报信息,包括受影响的路线、时间段和影响详细信息

鼓励

  • transport-disruption-summary -生成当前运输警报的摘要
    • 包括相关警报详细信息作为嵌入式资源
    • LLM重大中断总结的结构化提示

运输方式

支持以下运输方式:

  • all -所有运输方式
  • buses -悉尼地铁和外地铁巴士服务
  • ferries -悉尼渡轮和纽卡斯尔运输渡轮
  • lightrail -轻轨服务
  • metro -悉尼地铁
  • nswtrains -新南威尔士州火车区域列车和长途汽车
  • regionbuses -区域巴士服务
  • sydneytrains -悉尼火车郊区和城际网络

认证

此服务器需要使用TfNSW Open Data API进行身份验证。您需要在上注册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" 使用您的新南威尔士州交通局API密钥 新南威尔士州交通局开放数据中心.

发展

将API密钥配置为 .env 文件:

NSW_TRANSPORT_API_KEY="your_api_key_here"

安装依赖项:

npm install

构建服务器:

npm run build

对于自动重建的开发:

npm run watch

调试

您可以使用 MCP检查员 用于调试,它作为包脚本提供:

npm run inspector

检查器将提供一个URL,用于访问浏览器中的调试工具。

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。