Tba MCP Server

🚀 The Blue Alliance MCP Server

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

✨ 主な機能

• チーム情報：詳細なチームプロフィール、参加履歴、受賞歴、メディアを取得できます。
• イベントデータ：イベントの詳細、順位、試合、敗者復活戦のアライアンスにアクセスできます。
• 試合結果：得点、アライアンス、ブレイクダウンを含む試合データを取得できます。
• 過去のデータ：1992年から現在までのデータを照会できます。
• 型安全性：すべてのレスポンスはZodスキーマで検証されます。
• 包括的なカバレッジ：35以上のツールで、The Blue Alliance APIの主要なエンドポイントを網羅しています。

📦 インストール

npmからのインストール

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

ソースからのインストール

git clone https://github.com/withinfocus/tba-mcp-server.git
cd tba-mcp-server
npm ci
npm run build

🔧 設定

The Blue Alliance APIキーを環境変数として設定します。

export TBA_API_KEY=your_api_key_here

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

TBA_API_KEY=your_api_key_here

💻 使用例

基本的な使用法

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

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

高度な使用法

チーム情報の取得

// 詳細なチームプロフィールを取得
get_team(team_key: "frc86")

// 特定の年のチームのイベントを取得
get_team_events(team_key: "frc86", year: 2024)

// チームの受賞歴を取得
get_team_awards(team_key: "frc86", year: 2024)

イベントの分析

// イベントの詳細を取得
get_event(event_key: "2024casj")

// 参加チームを取得
get_event_teams(event_key: "2024casj")

// 順位を取得
get_event_rankings(event_key: "2024casj")

// 敗者復活戦のアライアンスを取得
get_event_alliances(event_key: "2024casj")

試合データの取得

// 詳細な試合情報を取得
get_match(match_key: "2024casj_qm1")

// ロボットの追跡データを取得（利用可能な場合）
get_match_zebra(match_key: "2024casj_qm1")

📚 ドキュメント

利用可能なツール

チーム情報（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以上のすべてのツールの完全なリファレンス（パラメーターと例付き）
• データスキーマ - すべてのレスポンスタイプの詳細なスキーマドキュメント
• 開発ガイド - ビルド、テスト、貢献方法

🔧 技術詳細

開発に関する詳細な手順は、開発ガイドを参照してください。

• ビルドとテスト
• 新しいツールの追加
• 単体テストと統合テストの実行
• コード標準と貢献ガイドライン

クイックスタート：

npm ci                   # 依存関係のインストール
npm run build            # TypeScriptのビルド
npm test                 # 単体テストの実行
npm run test:integration # 統合テストの実行
npm run lint             # コード品質のチェック
npm run inspect          # MCPインスペクターの起動

関連リンク

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