Mobility Database

@pipeworx/mobility-database

MobilityData が管理する公共交通データフィードのオープンカタログです。約 70 か国にわたる約 4,500 件の GTFS Schedule フィードと約 1,900 件の GTFS-Realtime フィードを収録し、それぞれに事業者独自のダウンロード URL、ライセンス、バウンディングボックスが記載されています。TransitFeeds の後継です。

Pipeworx の一部です。AI エージェントを 1683 以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• mobilitydb_search_feeds(query?, country?, municipality?, provider?, data_type?, include_inactive?, limit?) — 事業者、都市、国の交通フィードを検索します。
• mobilitydb_gtfs_rt_feeds(country?, query?, entity_type?, group_by_agency?, limit?) — リアルタイムフィード（車両位置／トリップ更新／運行アラート）と、それぞれが対応付けられているスケジュールフィードを取得します。
• mobilitydb_feed(feed_id) — 1 件のフィードについてカタログに記録されたすべての情報に加え、関連するリアルタイムストリームと後継のエントリを取得します。

認証

キーは不要です。

MobilityData は api.mobilitydatabase.org で認証付き REST API も運用しています。この API では、https://mobilitydatabase.org/sign-up から無料登録して発行されるリフレッシュトークンを使って生成したベアラートークンが必要です。このパックでは意図的にこの API を使用せず、プラットフォームキーも宣言していません。カタログのエクスポートには認証情報なしで同じフィード一覧が含まれており、ゲートウェイが保持していないキーの環境変数を宣言すると、呼び出しを拒否するしかないツールへルーティングされてしまうためです。認証付き API で追加されるのは、バージョンごとのデータセット履歴と MobilityData 独自の検証レポートです。これらが必要な場合は、PLATFORM_MOBILITYDB_TOKEN とそれを使用するコードを、1 つの変更でまとめて追加します。

データソース

• https://files.mobilitydatabase.org/feeds_v2.csv — カタログのエクスポート（後継エントリを含めて約 6,475 行）。

注意点（2026-09-17 に実データで確認済み）

• 通常の CSV であり、単純に行分割できません。 フィード名や注記には、カンマ、引用符、CJK テキスト、入れ子の括弧が含まれます。"TC_大有巴士(公總) (Dayou bus (public bus))" のようなデータです。 , で分割すると、事業者の連絡先メールアドレスが data_type 列に入ってしまいます。この用途に対応する RFC 4180 パーサーが src/index.ts にあります。
• 1 つの事業者が、entity_type ごとに 1 行、計 3 行のリアルタイムデータを公開しています。 vp は車両位置、tu はトリップ更新、sa は運行アラートを示し、それぞれ URL が異なります。static_reference でまとめずに「リアルタイムフィード」を数えると、事業者数が 3 倍になります。
• リアルタイムフィードは、スケジュールフィードがなければ使用できません。 static_reference が対応するフィードを示します。リアルタイムのトリップ ID は、その特定の GTFS フィードに対してのみ解決できます。
• フィードによっては、利用者自身が交通事業者から認証情報を取得する必要があります（urls.authentication_type が 1 または 2、パラメーター名は urls.api_key_parameter_name に記載）。認証情報は呼び出し元と事業者の間で扱われます。取得前に確認できるよう、その情報を報告します。
• redirect.id は後継エントリに置き換えられたエントリを示します。 そのエントリはエクスポート内に残っているため、そうでなければ有効なフィードに見えてしまいます。

クイックスタート

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

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

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

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

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

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが一覧に直接表示されます。

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/mobilitydb_search_feeds \
  -H 'Content-Type: application/json' \
  -d '{"query":"BART","country":"US","limit":2}'

最初の呼び出しにアカウントは必要ありません。任意のツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/mobilitydb_search_feeds を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

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

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-mobility-database

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Mobility Database data" })

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

詳細

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

ライセンス

MIT