Claudinho — live 2026 World Cup scores for your AI agent (stdio, npm)

@claudinho/mcp ⚽

一个 MCP 服务，让你的编码 Agent 能够回答足球相关问题：实时比分、赛程、积分榜，以及可直接分享的比赛卡片，覆盖你关注的赛事：世界杯、英超、西甲、欧冠和另外 12 项赛事。 它适用于 Claude Code、Cursor、Codex、Claude Desktop、Windsurf、Zed、VS Code，以及任何可运行本地（stdio）服务的 MCP 客户端。无需 API 密钥、注册或账户。

安装

该服务通过 npx 运行，因此需要 Node.js 22 或更高版本。这是它支持的最早版本线，不代表安全级别：请使用 Node 22 或 24 版本线中已应用安全补丁的版本。

Claude Code

claude mcp add claudinho -- npx -y @claudinho/mcp

Codex CLI

codex mcp add claudinho -- npx -y @claudinho/mcp

Cursor、Claude Desktop、Windsurf、Zed、VS Code：将以下内容添加到客户端的 MCP 配置中（对于 Cursor，使用 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json；对于 Claude Desktop，前往 Settings → Developer → Edit Config，然后重启）。某些客户端（VS Code、Zed）会将相同的 command 和 args 放在各自的配置键下：请参阅客户端的 MCP 文档。

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

也在使用 Cursor CLI？claudinho init cursor（来自 @claudinho/cli）会将实时比分显示在状态栏中，并生成此配置供你粘贴。

提出你的第一个问题

该服务一次只针对一项赛事作答。你可以在问题中直接说明赛事：

“今天有哪些欧冠比赛？” · “给我看看英超积分榜” · “阿森纳下一场欧冠比赛是什么时候？”

或者通过 CLI 设置一次，然后直接提问：

npx @claudinho/cli follow champions-league --team Arsenal

“今天有哪些比赛？” · “给我看看实时比分” · “我们的下一场比赛是什么时候？” · “帮我制作一张今天可分享的卡片”

如果没有指定赛事，针对单项赛事作答的工具会告诉你如何选择赛事。

工具

所有工具均为只读，其中两个工具绝不会访问网络。

工具	功能
get_today	根据调用方的时区获取某个日期（默认为今天）的赛程，并提供实时比分
get_live	获取正在进行的比赛
get_match	根据 ID 获取一场比赛，并提供数据源为正在进行或已结束的比赛发送的进球和牌
get_next_fixture	根据名称或代码获取某支球队的下一场比赛（Arsenal、ARS、Mexico、MEX）；未指定 team 时，使用服务的 CLAUDINHO_TEAM；如果请求涉及该球队参加的赛事，则使用用户固定的球队（claudinho follow <alias> --team <name>）
get_standings	获取积分榜：所有榜单，或根据其键获取某个榜单（小组字母，或 A1、A-B、LEAGUE）
get_bracket	获取淘汰赛对阵表，仅限世界杯，涵盖 32 强赛至决赛；可选的 stage（R32、R16、QF、SF、3P、F）用于仅保留某一轮
get_share_snippet	获取纯文本卡片，可用于比赛、某支球队的下一场比赛、积分榜、对阵表（bracket: true，可选 knockoutStage）、某个日期或实时赛况；按原样提供给用户
get_market_signal	获取世界杯比赛的预测市场赔率，可按比赛（matchId）、某支球队当前或下一场比赛（team，例如 MEX 这样的 3 字母代码）或日期查询；仅供参考
get_team	将世界杯参赛国的名称或代码对应到其 FIFA 代码、旗帜和小组（离线）
list_competitions	获取支持的赛事、各赛事接受的别名和提供的内容，以及当前生效的赛事（离线）

除 get_team 外，所有工具都可选用 competition（例如 champions-league 这样的别名），并且大多数工具都支持 tz、lang（en、es、pt、fr）和 flavor（off、subtle、full）。

资源：standings://{group} 和 fixtures://{date}（随附的世界杯赛程）。 提示词：my_team（你关注的赛事中，你的球队的下一场比赛及其排名）和 tournament_today。

预测市场赔率（世界杯）

对于世界杯比赛，如果存在可靠的 Polymarket 市场，get_today、get_match 以及针对比赛、某支球队下一场比赛或某个日期的 get_share_snippet 卡片会附上一行简短的“谁更被看好”信息；get_market_signal 则可单独读取相关市场。**仅供参考，并非投注建议：**显示带有 Polymarket 归属说明的市场隐含百分比，不提供链接或交易号召。已结束的比赛不会显示该信息。在服务的 env 中将 CLAUDINHO_MARKETS=off 设为关闭这行简短信息；get_market_signal 仍会正常响应。

解说

工具文本中的比赛信息行末尾会附上一句简短解说，使用读者的语言（— ¡GOOOOL!）；如果球队有自己的助威口号，则使用该口号（墨西哥的 ¿Y si sí?、Pumas 的 ¡Goya!、Arsenal 的 COYG!）。延期或取消的比赛不会附带解说。解说不会出现在结构化数据中。可在服务的 env 中将 CLAUDINHO_FLAVOR=subtle 或 off 调低解说强度，也可在每次调用时通过 flavor 设置。

面向 Agent 构建者的详情

选择赛事。 请求的赛事由其 competition 参数指定；若未指定，则使用服务端的 CLAUDINHO_COMPETITION；若仍未指定，则使用已保存的 claudinho follow <alias> 选择。未知值会导致工具错误，并列出别名。如果这三者都没有设置，所有回答赛事相关问题的工具都会在空结果中返回 noCompetition: true 和 competition: null，并附上一句说明该怎么做；list_competitions 则返回 current: null。

每个答案都包含的内容。 可供人阅读的文本和结构化内容，并根据每个工具声明的 outputSchema 进行验证。文本开头会说明对应的赛事（分享卡片会在标题中说明），结构化内容则通过 competition 标明赛事。有两个工具例外： get_team 无论赛事为何，都会读取世界杯的国家队数据，且不携带 competition；list_competitions 会在文本末尾说明当前生效的赛事，并在数据中通过 current 标明。

不完整的答案。 如果提供方发送的记录无法读取，get_today、get_live、get_match、get_next_fixture、get_bracket、get_market_signal 和 get_share_snippet 会在展示内容前说明这一点，并携带 partial（若已知，则包含省略的记录数 omitted）。空答案表示没有读取到任何内容，而不是没有相关内容。尤其要注意，缺少下一场比赛并不意味着球队已经出局。

俱乐部赛事。 get_next_fixture 和 get_match 会搜索从昨天到未来 14 天的比赛：空答案中携带的 horizon 或 window 表示的就是这个时间范围。如果一个名称匹配到多支球队，结果会以 candidates 返回。在两个赛季之间，get_today、get_live、get_next_fixture 和 get_match 会携带 betweenEditions。对于没有淘汰赛对阵的联赛赛季（英超、西甲），get_bracket 会返回 inapplicable；对于世界杯以外的所有其他赛事，则返回 unsupported。俱乐部没有 flag。比赛的 stage：联赛赛季为 REGULAR，杯赛的联赛阶段为 LEAGUE，附加赛为 PO；其他阶段为 OTHER，并在 stageLabel 中附上提供方的原始描述。

市场。 get_today、get_match，以及针对比赛、球队下一场比赛、日期或实时比赛的 get_share_snippet 卡片会携带 marketComplete（表格或淘汰赛对阵卡片不会）；get_market_signal 会携带 complete。false 表示可选的市场数据读取未完成，这与“没有信号”不同；文本和分享卡片也会说明这一点。CLAUDINHO_MARKETS_SOURCE=fake 会提供明确标注、无需联网的预览。

进程。 标准输出仅包含 MCP 协议；诊断信息写入标准错误流。在服务端的 env 中设置 CLAUDINHO_DEBUG=1，会将数据提供方的故障信息打印到标准错误流。

工作原理

世界杯的 104 场比赛随软件包一同提供。其他所有赛事的赛程和所有实时比分都来自 ESPN 的公共比分板（相关答案会注明 ESPN）。世界杯市场赔率来自 Polymarket 的公共数据。服务端的缓存仅保存在内存中。

隐私

不需要账户，不进行遥测、分析或追踪，也没有 Claudinho 服务端。服务端会向 ESPN（以及获取世界杯赔率时的 Polymarket）请求公共数据，不会附带任何与你有关的信息；这些服务仍会看到标准请求元数据，例如你的 IP 地址，这与任何网络请求一样。服务端不会向磁盘写入任何内容。完整政策： PRIVACY.md。

许可证

MIT © 2026 Arturo Garrido · 源代码和问题反馈

独立的球迷项目。与 FIFA、任何洲际联合会、联赛或俱乐部，以及 Anthropic 均无关联。

边看比赛边打造。 #VibingLaVidaLoca ⚽