TfNSW Realtime Alerts MCP Server

TfNSW リアルタイムアラート MCP サーバー

Transport for NSW（TfNSW）のリアルタイムアラート API 用の Model Context Protocol サーバーです。このサーバーは、LLM を通じてリアルタイムの交通アラートや情報にアクセスし、操作するためのツールを提供します。

概要

TypeScript ベースのこの MCP サーバーは、Transport for NSW のリアルタイムアラートシステムとの統合を実装しています。AI アシスタントが、NSW の交通ネットワーク全体における交通機関の運休や遅延、計画工事、その他の重要なアラートに関する最新情報にアクセスできるようにします。

機能

リソース

• nsw-transport:// URI を使って交通アラートの一覧表示やアクセスができます
• 交通機関の種類（バス、列車、フェリーなど）でアラートを絞り込めます
• AI アシスタントが簡単に利用できるプレーンテキスト形式です

ツール

• get-transport-alerts - 現在の交通アラートを取得します
  • 交通機関の種類で絞り込めます
  • 影響を受ける路線、期間、影響の詳細を含む、整形済みのアラート情報を返します

プロンプト

• transport-disruption-summary - 現在の交通アラートの概要を生成します
  • 関連するアラートの詳細を埋め込みリソースとして含みます
  • 主要な運行障害を LLM が要約するための、構造化されたプロンプトを返します

交通機関の種類

以下の交通機関の種類に対応しています。

• all - すべての交通機関
• buses - シドニーメトロおよびアウターメトロのバスサービス
• ferries - シドニーフェリーおよびニューカッスルトランスポートのフェリー
• lightrail - ライトレールサービス
• metro - シドニーメトロ
• nswtrains - NSW Trains の地域列車および長距離バス
• regionbuses - 地域バスサービス
• sydneytrains - シドニー・トレインズの郊外および都市間ネットワーク

認証

このサーバーでは、TfNSW Open Data API による認証が必要です。TfNSW Open Data Hub で 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 Open Data Hub で取得した 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 ファイルをご覧ください。