Carris Metropolitana

carris-metropolitana-mcp

Carris Metropolitana（リスボン大都市圏のバスネットワーク）向けのMCP サーバーです。Claude（または任意のMCP クライアント）が、「Xのバス停に次のバスが来るのはいつ？」「4715番の路線はどこへ行く？」「自分の路線は運休している？」といった質問にリアルタイムで回答できます。

読み取り専用で、キーもアカウントも不要です。 公式のオープンAPIを読み取るだけです。Carris MetropolitanaおよびTML（Transportes Metropolitanos de Lisboa）とは無関係です。

注：リスボン市内のバスの大半は、別会社のCarrisが運行しており、このサーバーでは対象外です。Carris Metropolitanaは周辺自治体とリスボンへの路線（例：Oriente、Cacilhas、Setúbal発）を運行しています。

ツール

find_stops

停留所名および／または座標付近から停留所を検索します。まずこれを使ってstop_idを取得してください。

パラメーター：

• query — 停留所名に含まれるテキスト。アクセントや大文字・小文字は区別されません（例："Gare do Oriente"、"cacilhas terminal"）。6桁の停留所IDも使用できます
• lat / lon — 座標。結果は直線距離順に並びます
• radius_m — この半径内にある停留所のみを対象にします（queryを指定しない場合のデフォルトは500 mです）
• limit — 停留所の最大数（デフォルトは10、最大50）

各停留所には、ID、名称、地区、自治体、距離、座標、停車する路線、車いすでの乗車可否が含まれます。

next_arrivals

停留所に到着予定のバスと、現在からの所要分数を表示します。各到着予定には、"realtime"（ライブGPSによる推定時刻で、時刻表との差を含む）または"scheduled"（時刻表のみ）のマークが付きます。

パラメーター：

• stop_id — 6桁の停留所ID（例："060361"）
• line_id — 任意。指定すると1路線のみに絞り込みます（例："2794"）
• limit — 到着予定の最大数（デフォルトは10、最大50）

line_info

路線名、運行する自治体と地区、各方向の情報（行先表示、始発停留所と終点停留所、停留所数、本日の運行便数、本日の始発・最終出発時刻）を表示します。路線番号（"4715"）またはテキスト（"Oriente Setubal"）を渡すと、一致する路線が一覧表示されます。include_stops=Trueを指定すると、各方向の停留所一覧が順番に追加されます。

service_alerts

運行中および、デフォルトでは今後発生する運行情報を表示します。迂回、工事、ストライキ、停車しない停留所などが含まれます。line_idおよび／またはstop_idで絞り込めます。運行情報の大半はポルトガル語で公開されています。

vehicle_positions

路線を現在運行中のバスのライブ位置を表示します。座標、進行方向、速度、行先表示、現在停車中または向かっている停留所、GPS測位からの経過時間が含まれます。

時刻はすべてEurope/Lisbonです。失敗した場合、ツールは例外を発生させず、{"error": "..."}を返します。

インストール

最も簡単な方法（uvが必要です）：クローンは不要で、PyPIから直接実行できます。

claude mcp add carris-metropolitana -- uvx carris-metropolitana-mcp

Claude Desktopでは、"command": "uvx", "args": ["carris-metropolitana-mcp"]を使用してください。

ソースからインストールする場合：

Python 3.10以降が必要です。

git clone https://github.com/ThiagoJacobLannes/carris-metropolitana-mcp
cd carris-metropolitana-mcp
python -m pip install -e .

Windowsで、Google DriveやOneDriveなどのクラウド同期フォルダーにコードを置く場合は、仮想環境をその外に作成してください。同期クライアントがフォルダーにdesktop.iniファイルを追加するため、パッケージの起動時にクラッシュすることがあります。

Claude Codeに追加する

claude mcp add carris-metropolitana -- python -m carris_metropolitana_mcp.server

Claude Desktopに追加する

claude_desktop_config.snippet.jsonの内容をClaude Desktopのclaude_desktop_config.jsonに統合し、その後Claude Desktopを再起動してください。

{
  "mcpServers": {
    "carris-metropolitana": {
      "command": "python",
      "args": ["-m", "carris_metropolitana_mcp.server"]
    }
  }
}

データソース

すべてのデータは、Carris Metropolitana の公式オープン API（https://api.carrismetropolitana.pt/v2）から取得しています（ドキュメント、ソース）。公開されており、キーは不要です。また、運営元のウェブサイトやアプリで使われているものと同じ API です。Carris Metropolitana はこのデータをオープンデータとして公開していますが、ドキュメントには特定のデータライセンスが記載されていないため、データそのものを再配布する前に利用条件を確認してください。

大規模で更新頻度の低い一覧（約12,000か所の停留所、約700路線、地域、自治体）は一度ダウンロードし、メモリ内に12時間キャッシュされます。アラートと車両位置は30秒間キャッシュされます。別の API ベース URL を指定するには、CARRIS_METROPOLITANA_BASE_URL を設定してください。

リアルタイムの到着予測は、ライブ追跡中のバスに限って利用できます。それ以外の到着時刻は公開時刻表に基づきます。到着情報は当日の運行分のみを対象としているため、夜遅い時間帯は一覧が短くなる場合があります。

このプロジェクトは Carris Metropolitana または TML とは提携しておらず、承認を受けておらず、関係もありません。

ライセンス

MIT