Statbotics

Statbotics MCP サーバー

FIRST Robotics Competition の統計データと予測を扱う Statbotics API へのアクセスを提供する、Model Context Protocol（MCP）サーバーです。AI アシスタントやその他の MCP クライアントが、FRC チームの EPA 評価、イベント予測、試合分析を取得できます。

機能

• チーム統計：FRC チームの EPA 評価、勝率、過去の成績を取得します
• イベントデータ：イベントの詳細、予測、イベントでのチーム成績にアクセスします
• 試合分析：試合予測、結果、チーム単位の試合統計を取得します
• 年度別データ：2002 年から現在までの統計的傾向を照会します
• 型安全性：すべてのレスポンスを Zod スキーマで検証します
• API キー不要：Statbotics API は無料で利用できます

インストール

npm（推奨）

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

Docker

GitHub Container Registry からイメージを取得します：

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

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

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

使用方法

npm を使用する場合

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

{
  "mcpServers": {
    "statbotics": {
      "command": "npx",
      "args": ["-y", "@withinfocus/statbotics-mcp-server"]
    }
  }
}

Docker を使用する場合

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

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

利用可能なツール

年度ツール（2 個）

シーズン単位の統計データを照会します。

ツール：get_year、get_years

チームツール（2 個）

チームプロフィールと EPA 評価にアクセスします。

ツール：get_team、get_teams

チーム年度ツール（2 個）

特定のシーズンにおけるチーム統計を取得します。

ツール：get_team_year、get_team_years

イベントツール（2 個）

イベントの詳細と予測を照会します。

ツール：get_event、get_events

チームイベントツール（2 個）

特定のイベントでのチーム成績を取得します。

ツール：get_team_event、get_team_events

試合ツール（2 個）

試合データと予測を取得します。

ツール：get_match、get_matches

チーム試合ツール（2 個）

チーム単位の試合統計を取得します。

ツール：get_team_match、get_team_matches

使用例

チーム情報を取得する

// Get team EPA ratings and statistics
get_team(team: 86)

// Get team's performance in a specific year
get_team_year(team: 86, year: 2024)

イベントを分析する

// Get event statistics
get_event(event: "2024flor")

// Get all team performances at an event
get_team_events(event: "2024flor")

試合データを取得する

// Get match predictions and results
get_match(match: "2024flor_qm20")

// Get team's performance in a match
get_team_match(team: 86, match: "2024flor_qm20")

貢献

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

関連リンク

• Statbotics - FRC の統計分析
• Statbotics API ドキュメント - 公式 API ドキュメント
• Model Context Protocol - MCP 仕様
• FIRST Robotics Competition - FRC 公式サイト