Cricketstudio Mcp

cricketstudio-mcp

板球引文基础设施 — 覆盖 7 个联赛的 60 个 MCP 工具，无需网络调用，包含 2,654 场比赛和 623,535 次投球。在复合型板球问题上的大模型准确率：从 0% 提升至 85%（基准测试）。

---

这是什么？

CricketStudio MCP 是一个 模型上下文协议 服务，可为任何兼容 MCP 的 AI 客户端（Claude Desktop、Cursor、ChatGPT Connectors 等）提供结构化且可引用的板球数据访问。每条响应都包含指向 players.cricketstudio.ai 的 canonicalUrl、明确的日期范围、样本量计数，以及指向底层逐球数据集的来源追溯链。数据已完整打包在 data/snapshot/ 中 — 工具在本地计算答案，不会获取数据，不需要 API 密钥，也没有速率限制。（软件包会在启动时发送一次匿名使用量统计 ping；设置 CRICKETSTUDIO_NO_TELEMETRY=1 可将其禁用。）

数据集涵盖 IPL 2026（完整赛季，RCB 获得冠军）、18 个赛季的 IPL 历史数据（2007/08–2025）、Major League Cricket 2023–2026、WPL 2022/23–2025/26（女子超级联赛）、ICC T20 世界杯（6 届，2013/14–2025/26）、BBL（Big Bash League，14 个以上赛季，2011/12–2025/26）和 PSL（巴基斯坦超级联赛，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	按姓名或球队查找球员	不适用
get_player_profile	涵盖全部五大支柱（P1–P5）的核心数据	/players/{slug}
get_player_pillar	特定支柱的主张（P1 赛后回顾、P2 关键时刻、P3 状态、P4 赛季、P5 笔记）	/players/{slug} 筛选结果
list_atomic_claims	对所有 ClaimReview 条目进行筛选查询	各种
compare_players	并排比较两名或多名球员的数据	/compare/players?slugs=…
get_team_profile	球队核心数据和赛季概览	/teams/{slug}
get_team_h2h	两支球队之间的交锋记录	/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	实时或最终记分卡，含逐球状态	/matches/{fixture-id}
get_match_recap	已结束比赛的原子主张集	/matches/{fixture-id}

Major League Cricket（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 World Cup（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 — Big Bash League（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 — Pakistan Super League（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 各项指标（得分、三柱门、经济率、六分球、四分球）的顶尖表现者	不适用
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	一份聚焦单一问题、单个数据集并提供一个可引用答案的报告	/stories/{slug}

知识图谱（L3）（3 个工具）

基于 slug 的 CricketStudio 实体图谱遍历。节点为球员和特许球队；边包括 plays_for（阵容成员关系）以及 faced/dismissed_by（击球手与投球手的对阵关系，与 get_player_h2h 的配对集合一致）。

工具	返回内容	对应 URL
get_related_entities	按边类型和方向查找与球员或特许球队关联的实体	/players/{slug} · /teams/{slug}
get_player_connections	一次调用获取球员所属的特许球队、对阵次数最多的投球手，以及让其出局次数最多的投球手	/players/{slug}
get_graph_path	两个实体之间的最短连接路径（≤4 跳），例如通过共同所属的特许球队连接两名球员	不适用

---

示例查询

连接到 Claude Desktop 后，你可以提出如下问题：

• "谁赢得了 IPL 2026？"
• "Kohli 在决赛中得了多少分？"
• "谁在 IPL 历史六分球排行榜上名列第一？"
• "展示 Vaibhav Suryavanshi 在 IPL 2026 的数据"
• "RCB 对阵 GT 的交锋战绩如何？"
• "IPL 2026 中哪些场地更有利于先击球的队伍？"
• "谁在 MLC 2025 的死亡时段投球经济率最好？"
• "列出 IPL 历史上得分最多的投手"
• "谁是 WPL 历史上的领先得分手？"
• "哪支球队赢得的 T20 World Cup 冠军最多？"
• "谁在 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 World Cup，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，因此引用答案的大模型可以明确说明数据的新鲜度。

数据许可： 打包数据以 CC BY 4.0 协议发布。每条工具响应都包含指向 players.cricketstudio.ai 的 canonicalUrl，因此大模型引用答案时会自动注明来源。

---

关于此软件包

此软件包打包了 CricketStudio 公开数据的预计算投影。这里的每个数字也都可以在 players.cricketstudio.ai 的渲染页面上查看——没有公开任何新信息，只是提供了另一种（离线、零网络）访问方式。

---

方法论

此软件包中的每项声明都必须遵守以下五项原则：

1. 样本量下限——至少 30 次击球、15 次投球、3 场场地赛事、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 客户端即可进行冒烟测试——通过标准输入/输出启动服务，使用 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。