Tfnsw Realtime Alerts MCP Server

🚀 新南ウェールズ州リアルタイムアラートMCPサーバー

このサーバーは、Model Context Protocol（MCP）を用いたサーバーで、Transport for NSW（TfNSW）のリアルタイムアラートAPIに対応しています。大規模言語モデルを通じて、リアルタイムの交通アラートや情報を取得するためのアクセスとインタラクションのツールを提供します。

🚀 クイックスタート

このサーバーは、TypeScriptベースの言語サーバーで、新南ウェールズ州運輸局のリアルタイムアラートシステムと統合されています。これにより、AIアシスタントは最新の交通障害、計画された工事、およびその他の重要な交通ネットワークのアラート情報にアクセスできます。

✨ 主な機能

リソース

• nsw - transport:// URIを使用して交通アラートをリストし、アクセスすることができます。
• 交通手段（バス、電車、フェリーなど）でアラートをフィルタリングできます。
• AIアシスタントが消費しやすい純粋なテキスト形式で提供されます。

ツール

• get - transport - alerts - 現在の輸送アラートを取得します。
  • 交通手段でフィルタリングできます。
  • 影響を受けるルート、時間範囲、および影響の詳細を含む、フォーマットされたアラート情報を返します。

ヒント

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

🚆 交通手段

以下の交通手段がサポートされています。

• all - すべての交通手段
• buses - シドニーメトロおよび周辺のメトロバスサービス
• ferries - シドニーフェリーおよびニューカッスル運輸フェリー
• lightrail - 路面電車サービス
• metro - シドニーメトロ
• nswtrains - NSW鉄道の地域列車および客車
• regionbuses - 地域バスサービス
• sydneytrains - シドニー鉄道の郊外および都市間ネットワーク

🔑 認証

このサーバーは、TfNSWのオープンデータAPIとの認証が必要です。APIキーを取得するには、TfNSWオープンデータプラットフォームに登録する必要があります。

📦 インストール

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ファイルを参照してください。