GTFS Scorecard

gtfs-scorecard

GTFS Scorecard を支える採点パイプライン、コマンドラインツール、読み取り専用 MCP サーバーです。公開 GTFS Schedule フィードを評価し、バリデーターの通知をわかりやすい修正方法に変換します。

機能

• scorecard try <feed-url> は、MobilityData バリデーターを使って 1 つの GTFS Schedule zip を採点し（Java 17 以降が PATH に必要です）、評価、カテゴリ別スコア、優先度の高い修正方法を表示します。
• scorecard-mcp は、stdio 経由で動作する読み取り専用の Model Context Protocol サーバーです。ツールは gtfsscorecard.org で公開されているスコアカードを読み取ります。追跡対象の事業者を検索したり、スコアカードとその修正方法を取得したり、フィードの評価履歴を読んだり、バリデーターの指摘内容を説明したりできます。キーは不要で、書き込み機能はありません。
• gtfs-scorecard は、配布名で提供される同じ MCP サーバーです。そのため、uvx gtfs-scorecard で起動できます。

Python のインポートパッケージ名は scorecard_pipeline です。配布名は 1.5.1 まで scorecard-pipeline でしたが、既存のプロジェクト名に似すぎているとして PyPI に拒否され、この名前で公開されたものはありません。

インストール

uvx gtfs-scorecard
uvx --from gtfs-scorecard scorecard try https://example.org/gtfs.zip
pip install gtfs-scorecard

1 つ目のコマンドは MCP サーバーを起動します。2 つ目のコマンドは独自の名前を持つコマンドラインツールを実行するため、提供元のパッケージを見つけられるように uvx に --from が必要です。 利用可能なバージョンは https://pypi.org/project/gtfs-scorecard/ をご確認ください。 未リリースのコードを実行するには、リポジトリからインストールします。

uvx --from "git+https://github.com/ChelseaKR/gtfs-scorecard#subdirectory=pipeline" scorecard-mcp

アシスタントを接続する

PyPI からサーバーを起動する MCP クライアントの設定例です。

{
  "mcpServers": {
    "gtfs-scorecard": {
      "command": "uvx",
      "args": ["gtfs-scorecard"]
    }
  }
}

フォークやローカルプレビューを指定するには、SCORECARD_BASE_URL を設定します。

詳細

• サイトとスコアカード：https://gtfsscorecard.org/
• 多数の事業者に対応するプログラム向けのレポートバンドル：https://gtfsscorecard.org/bundle/
• MCP ツールと回答できない内容：https://github.com/ChelseaKR/gtfs-scorecard/blob/main/docs/mcp.md
• フィードの評価をビルドのゲート条件にする GitHub Action：https://github.com/marketplace/actions/gtfs-scorecard-gate
• ソース、課題、変更履歴：https://github.com/ChelseaKR/gtfs-scorecard

Apache-2.0。