Cricsheet

@pipeworx/cricsheet

ボールごとのクリケットデータを、実際によく聞かれる質問に合わせて集約します。試合の結果とスコアカード、選手のキャリア通算の打撃・投球成績、2 チーム間の対戦成績を確認できます。テストマッチ、ワンデー・インターナショナル、T20 インターナショナル、インディアン・プレミアリーグに対応しています。Fleet #2975。

Pipeworx の一部です。AI エージェントを 1855 以上の稼働中データソースにつなぐ MCP ゲートウェイです。これは独立した非公式インテグレーションであり、上流プロバイダーとは提携、推奨、公開のいずれの関係もありません。

ツール

• cricsheet_match(match_id) — 1 試合の全結果に加え、各イニングの打撃カード（各打者の得点／投球数／4 打点／6 打点／アウトの方法）と投球カード（各投手のオーバー数／失点／ウィケット）を返します。まず cricsheet_find_matches を使って match_id を取得してください。
• cricsheet_player_stats(player, format?) — クリケット選手のキャリア通算の打撃・投球成績（出場試合数、得点、平均、ストライクレート、100 点／50 点；ウィケット数、投球平均、防御率）を返します。player は、このパックが保存する短縮形式の名前に対して、大文字と小文字を区別せず部分一致で照合されます（例：「V Kohli」を探す場合は「Kohli」）。曖昧なクエリの場合は推測せず、候補の一覧を返します。必要に応じて format を 1 つ指定できます。
• cricsheet_head_to_head(team_a, team_b, format?, limit?, offset?) — 合計試合数、各チームの勝利数、引き分け／ノーリザルト、および結果付きの直近の試合を返します。チーム名は Cricsheet 固有の表記と一致させる必要があります（例："India"、"Mumbai Indians"）。
• cricsheet_find_matches(team?, format?, season?, venue?, player?, limit?, offset?) — 試合インデックスを検索して match_id を見つけます。フィルターを指定しない場合、全形式を対象に直近の試合を返します。
• cricsheet_chase_search(second_innings_result?, format?, min/max_wickets_remaining?, min/max_balls_remaining?, team?, gender?, season?, event?, date_from?, date_to?, limit?, offset?) — ODI、T20I、IPL の試合で、追い上げる側（第 2 イニング）を対象に複合検索します。第 2 イニングの打撃チームが勝ったか、終了時に何ウィケット残っていたか、未使用の投球数を、日付、シーズン、トーナメント別に検索できます。balls_remaining は予定された全オーバー数（T20 は 120、ODI は 300）を前提とし、雨天時の方式で決着した試合では null になります。テストマッチは対象外です。

format には "Test"、"ODI"、"T20I"（国際 T20）、または "IPL" を指定します（大文字と小文字は区別されません）。省略すると、4 つすべての形式を対象に検索します。

このパックでできないこと： 個々の投球（ボールごとのデータ）は返しません。各試合ファイルは読み込み時に 1 度だけボールごとに解析し、試合／イニング／打撃カード／投球カードの行に集約します。約 11,000 試合分の全投球を保存すると、スコアカードで答えられる質問（「誰が何点取り、誰がどのウィケットを取ったか」）に対して、行数が約 150～200 倍に増えるためです。

認証

キーは不要です。ツールは Pipeworx ゲートウェイ経由でのみ応答し、データはゲートウェイ側にあります。単独で npm install しても読み込めるデータはなく、各ツールは空のリストを返す代わりに、そこで「このランタイムではバインドされていません」という明確なエラーをスローします。

データソース

• Cricsheet — テストクリケット、ワンデー・インターナショナル、T20 インターナショナル、インディアン・プレミアリーグのボールごとの試合データです。 ライセンス：ODC Attribution License（ODC-BY） — Cricsheet を出典として明記すれば、共有、改変、利用（商用利用を含む）が無料で可能です。Cricsheet は試合ごとの一括ファイルのみを公開しており（ライブ API はありません）、このパックはリクエストごとにプロキシするのではなく、バルクのみのソースに関する CLAUDE.md の「コピーを構築する」ルールに従い、D1 データベースにコピー（scripts/cricsheet/load-data.mjs）を構築します。

既知の不足点 — このパックを拡張する前にお読みください

Cricsheet の約 60 の大会のうち、読み込まれているのは 4 つだけです。 Cricsheet は、ファーストクラス、リスト A、および約 50 の国内 T20 リーグ（Big Bash、T20 Blast、Pakistan Super League、Caribbean Premier League、The Hundred など）も、それぞれ個別の一括ファイルとして公開しています。このパックでは、異なる形式をまたいで需要が最も明確な 4 つ（国際テスト／ODI／T20I と IPL。後者は当初の需要シグナルで明示されていたリーグ）を読み込みます。別のリーグを追加するには、ローダーの BULK_FILES にエントリーを 1 つ追加します。試合形式に依存しない同じパーサーを使用できます。

女子の試合は、Cricsheet 自身の一括ファイルに含まれている場合はすべて収録されます。 各試合について Cricsheet が保持する gender フィールドで区別しており、除外したり、別のツールで扱ったりはしていません。

選手の識別には、Cricsheet が使用する生の名前文字列を使います（例：「V Kohli」、「SR Watson」）。略式の名前であり、cricsheet_player_stats の部分文字列検索で得られる情報を除き、このパックでは独自の名前と人物の対応付けを管理していません。略式の名前が同じ別人 2 名が（約 8,400 の異なる名前の中ではまれですが、あり得ないわけではありません）その文字列で統合される可能性があります。Cricsheet のファイルには、それを解決できる情報はレジストリ ID（現在は読み込まれていません）以外にありません。

スーパーオーバーは、Cricsheet 自身の innings 配列での表現どおり、追加のイニングエントリーとして保存されます（同点の T20 では、イニングエントリーが 3 件または 4 件になることがあります）。cricsheet_match は、スーパーオーバーを含め、Cricsheet のファイルにあるすべてのイニングを返します。

データの更新または拡張

node scripts/cricsheet/load-data.mjs を再実行してください（Pipeworx の Cloudflare アカウントに wrangler でログインしている必要があります。また、表示されるアカウントが複数ある場合は CLOUDFLARE_ACCOUNT_ID を設定してください）。すべての形式のデータをライブで再取得し、すべてのテーブルを置き換えます（DROP + reload）。Cricsheet は過去のファイルにバージョンを付けるのではなく修正するためです。--only <Test|ODI|T20I|IPL> を指定すると単一の形式を再読み込みし、--dry-run を指定すると D1 に変更を加えずに解析して件数を出力します。これはパーサーの変更後に便利です。Cricsheet では新しい試合が継続的に追加されます（国際クリケットと IPL では、通常、試合の翌日までに追加されます）。新しい試合を取り込むため、定期的にローダーを再実行してください。各ツールの応答にある data_as_of には、そのツールが参照しているデータの読み込み日時が示されます。

クイックスタート

お使いの MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "cricsheet": {
      "url": "https://gateway.pipeworx.io/cricsheet/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/cricsheet/mcp の tools/list は、上記の表にあるツールに加え、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式）を返します。そのため、表示されるツール数はこの表の数より多くなります。単一パックのエンドポイントでは現在、このパック独自のツールと並んで、共通ツールが約 30 個表示されます。接続時の initialize の応答に正確なスコープが記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、ask_pipeworx を介してカタログ全体にルーティングできるため、このパックの対象外の質問にも、MCP サーバーを 2 つ目に追加せずに答えられます。現在、これらのメタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキストの消費がルーティングの利点を上回る場合は、複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと、同じ 1855 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/cricsheet_match \
  -H 'Content-Type: application/json' \
  -d '{"match_id":1082591}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/cricsheet_match を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "cricsheet": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-cricsheet"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-cricsheet

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Cricsheet data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT