Cricketstudio Mcp

cricketstudio-mcp

クリケットの引用インフラ — 7つのリーグに対応する60のMCPツール、ネットワーク呼び出しゼロ、2,654試合、623,535球。複合的なクリケットの質問に対するLLMの正答率：0% → 85%（ベンチマーク）。

---

これは何ですか？

CricketStudio MCPは、Claude Desktop、Cursor、ChatGPT Connectorsなど、MCP互換のあらゆるAIクライアントに、構造化された引用可能なクリケットデータへのアクセスを提供するModel Context Protocolサーバーです。すべての応答には、players.cricketstudio.aiへのcanonicalUrl、明示的な日付範囲、サンプル数、基盤となる投球単位のコーパスまでたどれる来歴情報が含まれます。データはすべてdata/snapshot/に同梱されているため、ツールの回答はローカルで計算され、データ取得の呼び出し、APIキー、レート制限は不要です。（パッケージは利用回数の集計のため、起動時に匿名のpingを1回送信します。CRICKETSTUDIO_NO_TELEMETRY=1で無効にできます。）

コーパスには、IPL 2026（全シーズン、RCBが優勝）、18シーズン分のIPLの歴史（2007/08–2025）、Major League Cricket 2023–2026、WPL 2022/23–2025/26（Women's Premier League）、ICC T20 World Cup（6大会、2013/14–2025/26）、BBL（Big Bash League、14シーズン以上、2011/12–2025/26）、PSL（Pakistan Super League、11シーズン、2016–2026）が含まれます。データはすべてCricsheet CC BY 3.0に基づいています。打撃に関する主張には、最低30球の対戦が必要です。投球に関する主張には、15球以上が必要です。この基準を満たさない主張は表示されません。

---

インストール

Claude Desktop

Claude Desktopの設定ファイルに追加し、アプリを再起動してください。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cricketstudio": {
      "command": "npx",
      "args": ["cricketstudio-mcp"]
    }
  }
}

その他のMCPクライアント

npx cricketstudio-mcp

stdioトランスポートに対応するMCPクライアントであれば、このコマンドをそのまま使用できます。サーバーはstdin/stdoutで起動し、Node 18以降が必要です。

---

ツール

57個すべてのツールが、同梱のスナップショットを使って完全に動作します。各応答にはcanonicalUrl、dataAsOf、sampleSizeが含まれます。

IPL 2026（20 個のツール）

ツール	返される内容	対応する URL
get_dataset_summary	コーパス全体の概要：シーズン、試合、選手、投球	/
search_players	名前またはチームによる選手の検索	n/a
get_player_profile	5 つすべての柱（P1～P5）にわたる主要な統計	/players/{slug}
get_player_pillar	特定の柱からの主張（P1 リキャップ、P2 注目の場面、P3 フォーム、P4 シーズン、P5 ノートブック）	/players/{slug} で絞り込み
list_atomic_claims	すべての ClaimReview エントリーを対象とした絞り込み検索	複数
compare_players	2 人以上の選手の統計を並べて比較	/compare/players?slugs=…
get_team_profile	チームの主要な統計とシーズン概要	/teams/{slug}
get_team_h2h	2 つのフランチャイズ間の直接対戦成績	/teams/{a}/vs/{b}
get_venue_hub	会場の集計パターン：パースコア、トスの影響、フェーズ別内訳	/venues/{slug}
get_standings	NRR を含む IPL 2026 の勝ち点表	/standings
get_trend	主張一式を含む、単一のトレンドに関する洞察	/trends/{id}
list_trends	カテゴリー別（条件、勢い、会場、トス、異常値）にトレンドを閲覧	/trends
get_player_h2h	バッター対ボウラーの対戦成績	/h2h/{batter}-vs-{bowler}
get_season_stats	指定した項目（得点、ウィケット、ストライクレート、エコノミーなど）のシーズンランキング	/season/ipl-2026/{aspect}
get_fielding_stats	選手またはシーズン全体のキャッチ、ランアウト、フィールディングへの貢献	/players/{slug} · /season/ipl-2026/catches
get_partnerships	試合または選手ペアのパートナーシップ記録	/matches/{id}
get_dismissal_analysis	バッターまたはボウラーの退場方法別内訳	/players/{slug}
list_fixtures	試合状況、会場、結果を含む全試合日程	/matches
get_match_state	1 球ごとの状況を含むライブまたは最終スコアカード	/matches/{fixture-id}
get_match_recap	完了した試合のアトミックな主張一式	/matches/{fixture-id}

メジャーリーグクリケット（8 個のツール）

ツール	返される内容	対応する URL
get_mlc_dataset_summary	MLC コーパスの概要：シーズン、試合、選手、投球	/leagues/mlc
search_mlc_players	MLC コーパス内で選手を検索	/leagues/mlc/players
get_mlc_player_profile	選手の MLC 通算成績およびシーズン統計	/leagues/mlc/players/{slug}
get_mlc_team_profile	フランチャイズのプロフィールとシーズン履歴	/leagues/mlc/teams/{slug}
get_mlc_match	試合のスコアカードと主要な主張	/leagues/mlc/matches/{id}
get_mlc_match_claim	MLC の試合に関する単一の型付き主張（最多得点者、最高投球成績など）	/leagues/mlc/matches/{id}/c/{kind}
list_mlc_matches	状況と結果を含む MLC の全試合	/leagues/mlc/matches
list_mlc_leaderboards	指定した MLC 項目のシーズンまたは通算ランキング	/leagues/mlc/leaderboards/{aspect}

WPL — 女子プレミアリーグ（5 個のツール）

ツール	返される内容	対応する URL
get_wpl_dataset_summary	WPL コーパスの概要：シーズン、試合、選手、投球（2022/23～2025/26）	/leagues/wpl
search_wpl_players	WPL コーパス内で選手を検索	/leagues/wpl/players
get_wpl_player_profile	選手の WPL 通算成績およびシーズン統計	/leagues/wpl/players/{slug}
get_wpl_leaderboard	WPL の任意の項目（得点、ウィケット、エコノミーなど）のシーズンまたは通算ランキング	/leagues/wpl/leaderboards/{aspect}
get_wpl_team_profile	フランチャイズのプロフィール、シーズン成績、チーム構成の統計	/leagues/wpl/teams/{slug}

ICC T20 ワールドカップ（5 ツール）

ツール	返される内容	対応する URL
get_t20wc_dataset_summary	T20 WC コーパスの概要：大会、試合、選手、投球（2013/14–2025/26）	/leagues/t20wc
search_t20wc_players	T20 WC コーパス内の選手検索	/leagues/t20wc/players
get_t20wc_player_profile	全大会を通じた選手の T20 WC 通算成績	/leagues/t20wc/players/{slug}
get_t20wc_leaderboard	T20 WC のあらゆる項目を対象とした全大会のリーダーボード	/leagues/t20wc/leaderboards/{aspect}
get_t20wc_team_stats	全 T20 WC 大会を通じた代表チームの通算成績	/leagues/t20wc/teams/{slug}

BBL — ビッグ・バッシュ・リーグ（5 ツール）

ツール	返される内容	対応する URL
get_bbl_dataset_summary	BBL コーパスの概要：シーズン、試合、選手、投球（2011/12–2025/26）	/leagues/bbl
search_bbl_players	BBL コーパス内の選手検索	/leagues/bbl/players
get_bbl_player_profile	選手の BBL 通算成績およびシーズン別成績	/leagues/bbl/players/{slug}
get_bbl_leaderboard	BBL のあらゆる項目（得点、ウィケット、経済率、シックスなど）を対象としたシーズン別または通算のリーダーボード	/leagues/bbl/leaderboards/{aspect}
get_bbl_team_profile	フランチャイズのプロフィール、シーズン履歴、通算成績	/leagues/bbl/teams/{slug}

PSL — パキスタン・スーパーリーグ（5 ツール）

ツール	返される内容	対応する URL
get_psl_dataset_summary	PSL コーパスの概要：シーズン、試合、選手、投球（2016–2026）	/leagues/psl
search_psl_players	PSL コーパス内の選手検索	/leagues/psl/players
get_psl_player_profile	選手の PSL 通算成績およびシーズン別成績	/leagues/psl/players/{slug}
get_psl_leaderboard	PSL のあらゆる項目（得点、ウィケット、経済率、シックスなど）を対象としたシーズン別または通算のリーダーボード	/leagues/psl/leaderboards/{aspect}
get_psl_team_profile	フランチャイズのプロフィール、シーズン履歴、通算成績	/leagues/psl/teams/{slug}

リーグ横断（3 ツール）

ツール	返される内容	対応する URL
get_cross_league_leaders	MLC、T20 WC、BBL、PSL における指標（得点、ウィケット、経済率、シックス、フォア）別の上位選手	n/a
get_player_all_leagues	コーパス内の全リーグ（IPL、MLC、WPL、T20 WC、BBL、PSL）における選手の成績	/players/{slug}
get_women_cricket_leaders	ジェンダー情報を含む WPL リーダーボード — 女子 T20 の上位選手	/leagues/wpl/leaderboards/{aspect}

IPL 通算／歴史データ（1 ツール）

ツール	返される内容	対応する URL
get_ipl_leaderboard	18 シーズン（2007/08–2025）にわたる、あらゆる項目の IPL 通算リーダーボード — 得点、ウィケット、シックス、センチュリー、経済率など	/leagues/ipl/leaderboards/{aspect}

リサーチ（2 ツール）

ツール	返される内容	対応する URL
list_research_reports	公開済みデータ調査（会場、ライバル関係、戦略、時代、リーグ横断、シーズン）の一覧	/stories
get_research_report	1 つの問い、1 つのデータセット、引用可能な 1 つの回答をまとめた個別レポート	/stories/{slug}

ナレッジグラフ（L3）（3 ツール）

CricketStudio のエンティティグラフを、スラッグをキーにたどります。ノードは選手とフランチャイズで、エッジは plays_for（チームへの所属）および faced/dismissed_by（打者対投手の対戦。get_player_h2h のペアセットと同様）です。

ツール	返される内容	対応する URL
get_related_entities	エッジの種類と方向に応じて、選手またはフランチャイズにつながるエンティティ	/players/{slug} · /teams/{slug}
get_player_connections	選手のフランチャイズ、最も多く対戦した投手、最も多くアウトにされた投手を 1 回の呼び出しで取得	/players/{slug}
get_graph_path	2 つのエンティティ間の最短のつながり（最大4ホップ）。例：共通のフランチャイズを介した 2 人の選手	n/a

質問例

Claude Desktop に接続したら、次のような質問ができます。

• 「IPL 2026で優勝したのはどのチームですか？」
• 「決勝でKohliは何点を取りましたか？」
• 「IPL通算の最多シックス記録で首位なのは誰ですか？」
• 「Vaibhav SuryavanshiのIPL 2026の成績を見せてください」
• 「RCBとGTの直接対決の成績はどうなっていますか？」
• 「IPL 2026で、先攻のチームに有利な会場はどこですか？」
• 「MLC 2025でデスオーバーの経済率が最も高いのは誰ですか？」
• 「IPL史上の最多ウィケット獲得者を一覧にしてください」
• 「WPL史上の最多得点者は誰ですか？」
• 「T20ワールドカップで最も多く優勝しているチームはどこですか？」
• 「WPLとT20 WCを合わせて、シックスを最も多く決めているのは誰ですか？」
• 「Smriti Mandhanaの全リーグでの成績を見せてください」
• 「BBL通算最多得点記録で首位なのは誰ですか？」
• 「最も多くタイトルを獲得しているBBLのフランチャイズはどこですか？」
• 「PSL史上の最多ウィケット獲得者は誰ですか？」
• 「Babar AzamのPSL通算成績を見せてください」
• 「David WarnerのIPL、BBL、PSLでの成績を比較してください」

---

データ

ソース	対象範囲	ライセンス
ライセンス済みフィード	IPL 2026のボールごとのデータ（シーズン全試合 — RCBが優勝）	プロプライエタリ
Cricsheet	IPLの過去データ、18シーズン、1,169試合（2007/08–2025）	CC BY 3.0
Cricsheet	MLC 2023–2026、75試合	CC BY 3.0
Cricsheet	WPL 2022/23–2025/26、88試合、133選手	CC BY 3.0
Cricsheet	ICC T20ワールドカップ、6大会、230試合、687選手	CC BY 3.0
Cricsheet	BBL 2011/12–2025/26、662試合、529選手	CC BY 3.0
Cricsheet	PSL 2016–2026、357試合、458選手	CC BY 3.0

コーパス合計： 2,654試合 · ボールごとの投球データ623,535件。

サンプルサイズの最低基準（公開済み）：

• 打撃に関する主張：対戦した投球数が30球以上
• 投球に関する主張：投球数が15球以上
• 会場に関する主張：その会場での試合が3試合以上
• 傾向に関する主張：傾向を示す試合が3試合以上

この基準に達しない主張は除外されます。プレースホルダーで伏せられるのではなく、単に表示されません。これが競争優位性です。

更新頻度： 同梱スナップショットは、CricketStudioのデータ更新ごとに更新されます。すべてのツール応答には dataAsOf が含まれており、回答を引用するLLMはデータの鮮度を明示できます。

データライセンス： 同梱データはCC BY 4.0で公開されています。すべてのツール応答には players.cricketstudio.ai への canonicalUrl が含まれており、LLMが回答を引用する際に帰属表示が自動的に行われます。

---

このパッケージについて

このパッケージには、CricketStudioの公開データを事前に計算したものが含まれています。ここにある数値はすべて、players.cricketstudio.ai のレンダリング済みページでも確認できます。新たな情報を公開するのではなく、別のアクセス手段（オフラインで、ネットワーク接続不要）を提供するだけです。

---

方法論

このパッケージ内のすべての主張は、次の5つの必須要件に従います。

1. サンプルサイズの最低基準 — 打撃は30球以上、投球は15球以上、会場は3試合以上、H2Hは5球以上、傾向は3試合以上。すべてのページで公開しています。
2. 明示的な日付範囲 — すべての主張に対象期間（ipl-2026、ipl-career、last-N-matches）を指定します。期間を定義せずに「通算」と表示することはありません。
3. ボールごとのデータに基づく出典 — すべての数値を、特定の試合、投球数、計算時刻までたどれます。
4. 原子的な主張形式 — 30語未満で、[Subject] [metric] [value] [comparator] [period] の形式で構成します。
5. 4時間未満の鮮度SLA — IPL 2026のページでは、試合終了からページ更新までの時間を95パーセンタイルで4時間未満にします。

方法論の詳細は https://players.cricketstudio.ai/about をご覧ください。

---

ローカル開発

npm install
npm run typecheck       # tsc --noEmit
npm start               # stdio MCP server via tsx

MCPクライアントなしでスモークテストを実行します — stdio経由でサーバーを起動し、JSON-RPCで操作して、公開されているすべてのツールが dataAsOf を含むエラーのないペイロードを返すことを検証します。

npm run smoke

---

何かを構築していますか？

cricketstudio.ai/developers に登録すると、ホスト型HTTPトランスポート（mcp.cricketstudio.ai）、リアルタイムのボールごとのエンドポイント、APIキーの各ティア、スナップショットではなくライブデータを提供する全57種類のツールカタログを早期に利用できます。

---

ライセンス

• コード： MIT — LICENSE をご覧ください
• データ： CC BY 4.0 — CricketStudio（https://players.cricketstudio.ai）を明記すれば、自由に引用できます。すべてのツールの応答に含まれる canonicalUrl フィールドによって、帰属表示が自動的に行われます。

---

Arul Anand が制作 · チェンナイ＆フリスコ · クリケット愛好家、データエンジニア。 質問、バグ報告、ご要望：issue を作成するか、players.cricketstudio.ai/mcp をご覧ください。