mcp-cricket

🏏 Cricket MCP サーバー

Claude Desktop、Claude Code、Cursor、その他あらゆる MCP クライアント向けのクリケット分析ツールです。調整済みの勝率モデル、22,479 試合のアーカイブ、 ライブ予測市場価格を提供します。

Model Context Protocol サーバーです。 AI アシスタントに、クリケットに関する実用的な知識を提供します。調整済みの勝率モデル、 22,000 試合以上の投球ごとのアーカイブ、ライブ予測市場価格、 キャリア記録、ライブスコアを利用できます。

クリケットについて普段の言葉で質問すると、学習データから思い出すのではなく、 データに基づいて算出した回答が得られます。

⚡ 1 ステップで追加

ホスト済みです。インストール、ダウンロード、ビルド、設定は必要ありません。

https://cricketfornoobs.com/mcp

これをクライアントのコネクター設定に貼り付ければ完了です。

クライアント	場所
Claude（無料プランを含む）	カスタマイズ → コネクター → カスタムコネクターを追加
ChatGPT	設定 → アプリ → 開発者モード → サーバーを追加
Claude Code	claude mcp add --transport http cricket https://cricketfornoobs.com/mcp
Cursor / VS Code	cricketfornoobs.com/mcp にあるワンクリックボタン
Gemini CLI	{"cricket": {"httpUrl": "https://cricketfornoobs.com/mcp"}} を ~/.gemini/settings.json に追加

アカウントも API キーもデータパイプラインも不要です。読み取り専用です。

自分のマシンで実行したい場合は、以下のクイックスタートをご覧ください。 同じツールを、静的バイナリ 1 つで利用できます。

💬 質問してみましょう

• 「今のインドの試合はどちらが勝っていて、モデルの予測はどうなっていますか？」
• 「Minor League Cricket の試合のスコアは？ どちらが有利ですか？」
• 「残り 3 オーバーで 178 点を追い、149/7 の状況では、どちらが有利ですか？」
• 「T20 での Kohli の Bumrah に対する打撃成績は？」
• 「Welsh Fire 対 Southern Brave について、市場予測とモデルの予測はどう違いますか？」
• 「Bumrah はどんな方法でウィケットを取っていますか？ ボウル、キャッチ、LBW のどれですか？」
• 「T20 での Rashid Khan のドットボール率は？」
• 「Kohli は先攻と追い上げのどちらの打席が得意ですか？」
• 「Rohit Sharma は誰と組んだときに最も多く得点していますか？」
• 「Grand Prairie Stadium は追い上げに有利ですか？」
• 「Pooran のデスオーバーでの成績を見せてください。」
• 「グーグリーとは、実際には何ですか？」

同じ勝率モデルは、アメリカのスポーツファン向けのクリケット解説サイト cricketfornoobs.com でも本番環境で稼働しています。 このサーバーでは、その分析機能をあらゆる MCP クライアントに提供します。

✨ このサーバーの特徴

多くのスポーツ向け MCP サーバーは、スコア API をラップしているだけです。 このサーバーは分析機能を提供します。

• 学習済みモデルによる勝率 — 10,847 試合（ボールの状態 340 万件）を対象に、 形式とイニングごとにロジスティック回帰を行い、試合前の Elo レーティングも使用します。 保留データでの対数損失は 0.42（T20 の追い上げ）／0.40（ODI の追い上げ）で、 確信度の高い予測の約 91% が的中します。149/7 で 178 点を追う状況は、 149/2 の状況と同じではないこともモデルは理解しています。
• 投球ごとのアーカイブ — T20、ODI／List-A、テスト、国内の複数日制クリケットを網羅する、 22,479 試合、1,140 万球のデータ。
• キャリア記録と対戦成績 — 打者対投手の直接対決、局面別の内訳 （パワープレイ／ミドル／デス）、会場レポート、リーグのランキング。
• 野球に置き換えた説明 — 初心者向けに、あらゆるクリケット用語を最も近い野球の用語で解説します。

🛠️ ツール

ツール	機能
cricket_win_probability	ライブまたは仮想のあらゆる試合状況での勝率
cricket_head_to_head	打者対投手の通算成績（投球数、得点、アウト、ストライク率）
cricket_player_career	男子・女子クリケットの形式別通算集計
cricket_match_archive	チーム／リーグ／年で検索できる、アーカイブ済み試合のスコアカード
cricket_phase_stats	パワープレー、中盤、デスオーバー別の打撃・投球成績
cricket_venue_stats	グラウンド情報：初回の平均得点、追い上げ時の勝率
cricket_leaders	得点またはウィケット数のリーグ別・シーズン別ランキング。t20i は T20I のみ、t20 は独自のコードがない国内 T20 も含みます。t20i、t20、odi、test、bbl、cpl、hundred は男子・女子の試合を収録し、gender が female でない限り男子のデータを参照します
cricket_team_form	チームの最近のアーカイブ済み試合結果。省略可能な format（t20、odi、test）と gender（male、female）で片方のチームの試合に絞り込めます。アーカイブでは、同じ国の男子チームと女子チームに同じ名前が使われています
cricket_dismissals	打者がアウトになる方法、または投手がウィケットを取る方法
cricket_discipline	ドットボール率とバウンダリー率。スコアカードには載らない数値です
cricket_situational	先攻時と追い上げ時の打者の成績
cricket_partnerships	各パートナーと打席に立った際の合計得点と、最高のパートナーシップ
cricket_market_odds	ライブ予測市場（Kalshi）の価格と、このモデルの予測値
cricket_live_matches	現在ライブ中および近日開催予定の試合
cricket_explain_term	野球での相当語とともに、あらゆるクリケット用語を説明します
cricket_minor_league	Minor League Cricket（米国国内 T20）と Atlanta Open T20：Kalshi のライブデータによるライブスコア、試合状況、勝率。Atlanta Open の打者、投手、トスの情報は、開催サーバー上のみで、同大会のスコア記録アプリ CricCenter から取得します
cricket_minor_league_info	Minor League の歴史、チーム、グラウンド、選手の記録。開催サーバー限定のデータです。ローカルビルドでは開催サーバーを案内します

すべてのツールは読み取り専用です。

Minor League Cricket のデータ。 ESPN はこのリーグを扱っていないため、試合予定とスコアには Kalshi の公開ライブデータを使用しています。これには日程、各試合のスコアと状況、Kalshi の市場情報が含まれます。このフィードには一球ごとの解説がなく、打者や投手の名前も記載されていないため、cricket_minor_league は誰が打席に立っているか、誰がウィケットを取ったか、特定の投球で何が起きたかを伝えることはできません。市場価格が表示されるのは、Kalshi の板に実際の価格がある場合のみです。また、モデルが算出する価格は追い上げ側のものに限られます。開催サーバーの cricket_minor_league_info では選手名を確認できます。CricClubs のスコアカードと試合結果、および Wikipedia のシーズン記事（CC BY-SA 4.0）を参照しているため、このデータは開催サーバー上にのみ置かれています。

🚀 クイックスタート

1. インストール

静的バイナリは1つだけで、ランタイム、インタープリター、依存関係は不要です。

go install github.com/asaraog/mcp-cricket/cmd/cricket-mcp@latest

または、macOS（Apple シリコンまたは Intel）、Linux （x86-64 または arm64）、Windows 用のビルド済みバイナリを Releases からダウンロードしてください。

Claude Code に登録します。

claude mcp add cricket -- ~/go/bin/cricket-mcp

2. またはデスクトップクライアントを設定

クライアントの設定にサーバーを追加します。Claude Desktop の場合：

OS	設定ファイル
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cricket": {
      "command": "/ABSOLUTE/PATH/TO/cricket-mcp"
    }
  }
}

クライアントを再起動すると、クリケットのツールが表示されます。ライブスコア、勝率モデル、市場価格、用語集はそのまま利用できます。アーカイブツールには一球ごとのデータベースが必要ですが、バイナリには含まれていません。

3. アーカイブ

データベースは、公開されている Cricsheet データから asaraog/cricket-history-data ワークフローで構築され、リリースアセット history-full.db.gz（206 MB）として 公開されています。このリリースは非公開です。読み取り権限のある GitHub トークンを HISTORY_DB_TOKEN に設定すると、サーバーは初回使用時に最新のリリースを解決し、 アーカイブを OS のキャッシュディレクトリ（macOS では ~/Library/Caches、Linux では ~/.cache、Windows では %LocalAppData%）に一度ダウンロードして、以後はそこから 再利用します。後続のリリースでアセットが置き換えられると、次回の起動時に新しいものを ダウンロードします。トークンがない場合、ダウンロードは失敗し、アーカイブ用ツールは アーカイブが見つからないことを通知します。

自分で構築する場合、トークンは不要です。

curl -O https://cricsheet.org/downloads/all_json.zip
python3 scripts/histgen.py all_json.zip history.db

次に、HISTORY_DB を構築結果の場所に設定します。自分で構築したファイルはそのまま 開かれ、ダウンロードによって置き換えられることはありません。オーバー数限定の アーカイブにも対応しています。形式が存在しない場合、ツールは問題なく動作を継続します。

scripts/histgen.py はワークフローが実行するものと同じスクリプトです。2026-10-06 以降、その deliveries テーブルには wide 列と noball 列があり、スコアカードの 数え方に合わせて、対戦打者の投球数からワイドを、ボウラーの投球数からワイドと ノーボールを除外します。それ以前に構築されたアーカイブにはどちらの列もありません。 サーバーは従来どおりそれを読み込み、すべての行を投球として数えます。

2026-10-07 以降、その matches テーブルには gender 列もあり、Cricsheet の記録に 従って male または female が格納されています。cricket_leaders と cricket_team_form はこの列で絞り込みます。古いアーカイブ（v1 ファイルと 2026-10-06 の再構築版）も引き続き動作します。この列がない場合、試合の性別は イベント名から判定します。Cricsheet の女子イベントでは、イベント名に「Women」と 記載されています。

⚙️ 設定

変数	用途
HISTORY_DB	アーカイブの保存場所（デフォルト：OS のキャッシュディレクトリ）
HISTORY_DB_URL	最新のリリースの代わりに、この URL からアーカイブをダウンロードします
HISTORY_DB_TOKEN	非公開リリースを読み取るための GitHub トークン、または HISTORY_DB_URL 用のベアラートークン
HISTORY_QUERY_TIMEOUT	試合検索とスコアカードの期限。デフォルトは 3s です
HISTORY_ANALYTICS_TIMEOUT	フェーズ別内訳、リーダー、退場、規律、状況別およびパートナーシップのクエリの期限。デフォルトは 15s です
MILC_LIVE	off にすると、Minor League Cricket のライブデータを無効にします

ライブスコア用ツールはアーカイブなしで動作します。アーカイブ用ツールは、 答えを捏造するのではなく、データベースが見つからないことを明確に通知します。

📊 モデルについて

勝率モデルはオフラインで学習され、実行時に推測で算出されることはありません。特徴量は 試合の状態（得点、ウィケット、残り投球数、必要ランレート）、試合前の Elo、 およびウィケット数 × 必要ランレートの相互作用項です。これは、必要ランレートが高いほど、 打線の層の薄さが勝敗に大きく響くためです。キャリブレーションは残りウィケット数に 基づいて測定され、ほとんどの範囲で約 1 ポイント以内です。

パーはグラウンドごとに異なります。 初回イニングの得点は、通常そのグラウンドで どれだけ得点が入るかとの比較で初めて意味を持ちます。そのため、初回イニングの区分は 単一の全体定数ではなく、371 のグラウンドと 7 つのリーグのテーブルに対して学習されます。 実際のパーはリーグだけでも 153.7 から 172.5 まで幅があり、グラウンドによってさらに 異なります。cricket_win_probability に venue（および league）を渡すと、 10 オーバー時点で 80/2 の場合でも、Chinnaswamy では 47%、Newlands では 60% になります。 会場を指定しない場合は、グラウンド → リーグ → 全体の順にフォールバックし、 ホールドアウトデータの対数損失が約 0.006 増加します。

負傷、天候、ピッチレポート、チームニュースは考慮できません。

📈 市場

cricket_market_odds は、Kalshi から公開価格を取得します。Kalshi は、契約が 1 ドルで決済される CFTC 規制下の米国取引所で、価格はセント単位で、暗示された確率を表します。 cricket_win_probability と並べて見ると、両者の差がトレーダーが主張するエッジになります。

これは情報提供のみを目的としています。市場データは読み取り専用で、アカウントも注文もなく、助言も行いません。モデルは負傷、天候、チームのニュースを把握できません。そのため、市場と異なる予測になることがよくあります。イベント契約は、管轄地域によって合法の場合とそうでない場合があります。

🙏 データ

Cricsheet の投球ごとのデータを使用しています。ライセンスは CC BY-SA 4.0 です。ライブスコアは公開されている ESPNcricinfo のエンドポイントから取得し、Minor League Cricket のライブスコアは Kalshi の公開ライブデータから取得しています。市場価格は Kalshi の公開 API から取得しています。 このプロジェクトは、これらのいずれとも提携していません。

📝 ライセンス

BSD 3-Clause です。LICENSE をご覧ください。