Tfnsw Realtime Alerts MCP Server

🚀 新南威爾士州即時警報 MCP 服務器

本項目是一個模型上下文協議（Model Context Protocol）服務器，專為新南威爾士州運輸局（Transport for NSW，簡稱TfNSW）的即時警報 API 打造。藉助大型語言模型，該服務器提供了一系列工具，可用於訪問和交互獲取即時交通警報與信息，為用戶及時掌握交通動態提供有力支持。

🚀 快速開始

此基於 TypeScript 的語言服務器實現了與新南威爾士州運輸局即時警報系統的集成，能讓 AI 助手訪問最新的交通中斷、計劃中的工程和其他重要的交通網絡警報信息。

若要與 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 密鑰。

✨ 主要特性

資源

• 可列出並通過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 文件。