Transport Nsw

@pipeworx/transport-nsw

シドニーおよびニューサウスウェールズ州全域の経路検索、リアルタイムの発車情報、運行アラート、通勤者向け駐車場の空き状況に対応しています。対象は鉄道、メトロ、バス、フェリー、ライトレールです。

Pipeworx の一部です。AI エージェントを1684以上のリアルタイムデータソースに接続するMCPゲートウェイです。

APIキーが必要です。https://opendata.transport.nsw.gov.au/ から無料でセルフサービスで取得できます。

• プラットフォームキー：PLATFORM_TFNSW_KEY
• 呼び出し元から指定する場合：任意のツールの_apiKey引数

ツール

ツール	回答する内容
tfnsw_departures	停留所、駅、埠頭からのリアルタイム発車情報
tfnsw_trip_plan	A地点からB地点までの複数区間にわたる経路全体
tfnsw_alerts	現在の運行障害と線路工事
tfnsw_carparks	パークアンドライド駐車場のリアルタイム空き状況

注意点

認証ヘッダーはベアラートークンではありません。 文字どおりapikeyという語の後にキーを続けます：Authorization: apikey abc123。Bearer abc123を送ると、「呼び出し元のアプリケーション」に関するメッセージとともに401が返されます。これは認証方式の誤りではなくキーの誤りのように読めるため、問題のないキーをローテーションすることになりかねません。

経路検索はRESTではなくEFAです。 /v1/tp/*はホスト型のMentz EFAインスタンスなので、パラメーターはEFAのもの（type_dm、name_dm、itdDate）です。また、「結果なし」の応答は、理由を説明するsystemMessages配列を含むHTTP 200であり、エラーステータスにはなりません。結果リストが空の場合はefaComplaint()がそのメッセージを表示します。これは、何も表示されない空の経路リストでは、「この2地点間に列車が運行していない」場合と区別できないためです。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "transport-nsw": {
      "url": "https://gateway.pipeworx.io/transport-nsw/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/transport-nsw/mcpのtools/listは、上の表にあるツールに加えて、共有Pipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使えるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに約30個の共有ツールが一覧表示されます。接続のinitialize応答に正確な範囲が記載されており、その日の状況を確認するうえでの正式な情報源です。

これは意図的な設計であり、偶発的な多重化ではありません。メタツールを使うと、このパックで扱っていない質問にも、カタログ全体を横断するask_pipeworx経由で回答できます。MCPサーバーを追加する必要はありません。現時点では、メタツールを除いてパックのエンドポイントを接続する方法はありません。追加のスキーマで消費されるコンテキストがルーティングの利点を上回る場合は、複数のパックエンドポイントに接続せず、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、フルPipeworxゲートウェイに接続してください：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1684以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworxを使えば、どちらからでもすべてのツールにアクセスできます。

MCPクライアントがない場合：HTTP経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/tfnsw_departures \
  -H 'Content-Type: application/json' \
  -d '{"stop_id":"200060"}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/tfnsw_departuresを実行します。ツールを探すには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルのstdio MCPサーバーとしても動作します。Pipeworxアカウントもゲートウェイへの往復通信も必要ありません：

{
  "mcpServers": {
    "transport-nsw": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-transport-nsw"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-transport-nsw

stdin/stdout経由でMCPを使用し、このパックのツールのみを対象にinitialize／tools/list／tools/callに応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを利用できますが、ask_pipeworxによるルーティングはありません。

ask_pipeworxの使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Transport Nsw data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT