The Blue Alliance

The Blue Alliance MCP サーバー

FIRST Robotics Competition のデータに関する The Blue Alliance API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。AI アシスタントやその他の MCP クライアントが、FRC のチーム、イベント、試合に関する包括的な情報を取得できます。

特長

• チーム情報：詳細なチームプロフィール、参加履歴、受賞歴、メディアを取得します
• イベントデータ：イベントの詳細、ランキング、試合、決勝トーナメントの同盟にアクセスします
• 試合結果：スコア、同盟、内訳を含む試合データを取得します
• 過去のデータ：1992年から現在までのデータを照会します
• 型安全性：すべての応答を Zod スキーマで検証します
• 幅広いカバー範囲：TBA API の主要なエンドポイントを網羅する35以上のツール

インストール

npm（推奨）

npm install -g @withinfocus/tba-mcp-server

Docker

GitHub Container Registry からイメージをプルします：

docker pull ghcr.io/withinfocus/tba-mcp-server:latest

または、ローカルでビルドします：

git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
docker build -t tba-mcp-server .

設定

1. The Blue Alliance から API キーを取得します

2. API キーを環境変数として設定します：

export TBA_API_KEY=your_api_key_here

または、.env ファイルを作成します：

TBA_API_KEY=your_api_key_here

使い方

npm を使用する場合

MCP クライアントの設定（例：Claude Desktop）に追加します：

{
  "mcpServers": {
    "tba": {
      "command": "npx",
      "args": ["-y", "@withinfocus/tba-mcp-server"],
      "env": {
        "TBA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker を使用する場合

MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "tba": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "TBA_API_KEY=your_api_key_here",
        "ghcr.io/withinfocus/tba-mcp-server:latest"
      ]
    }
  }
}

または、直接実行します：

docker run --rm -i --init \
  -e TBA_API_KEY=your_api_key_here \
  ghcr.io/withinfocus/tba-mcp-server:latest

利用可能なツール

チーム情報（24ツール）

プロフィール、参加履歴、イベント、試合、受賞歴、メディアなど、包括的なチームデータにアクセスします。

主なツール：get_team、get_team_events、get_team_matches、get_team_awards、get_team_media

イベント情報（19ツール）

イベントの詳細、参加者、ランキング、試合、分析情報を照会します。

主なツール：get_event、get_events、get_event_teams、get_event_rankings、get_event_matches、get_event_oprs

試合情報（3ツール）

スコア、同盟、ロボットのトラッキング情報など、詳細な試合データを取得します。

主なツール：get_match、get_match_simple、get_match_zebra

地区ツール（8ツール）

地区ランキング、イベント、チーム情報にアクセスします。

主なツール：get_districts、get_district_rankings、get_district_events、get_district_teams

一般／ユーティリティツール（6ツール）

ページネーションに対応したチーム一覧と API のステータス情報を取得します。

主なツール：get_teams、get_teams_by_year、get_status

詳細ドキュメント

• すべてのツール - 35以上のすべてのツールについて、パラメーターと使用例を含む完全なリファレンス
• データスキーマ - すべての応答タイプに関する詳細なスキーマドキュメント

簡単な使用例

チーム情報を取得する

// Get detailed team profile
get_team(team_key: "frc86")

// Get team's events in a year
get_team_events(team_key: "frc86", year: 2024)

// Get team's awards
get_team_awards(team_key: "frc86", year: 2024)

イベントを分析する

// Get event details
get_event(event_key: "2024casj")

// Get participating teams
get_event_teams(event_key: "2024casj")

// Get rankings
get_event_rankings(event_key: "2024casj")

// Get elimination alliances
get_event_alliances(event_key: "2024casj")

試合データを取得する

// Get detailed match information
get_match(match_key: "2024casj_qm1")

// Get robot tracking data (if available)
get_match_zebra(match_key: "2024casj_qm1")

コントリビューション

コントリビューションを歓迎します！開発環境のセットアップ、テストのガイドライン、新しいツールの追加方法については、CONTRIBUTING.md をご覧ください。

関連リンク

• The Blue Alliance - FRC の公式データソース
• TBA API ドキュメント - 公式 API ドキュメント
• Model Context Protocol - MCP の仕様
• FIRST Robotics Competition - FRC の公式サイト