适合谁
- 比赛期间在终端工作、想随时掌握比分的开发者
- 使用Claude Code或Cursor CLI并想要足球状态栏的用户
- 需要无密钥、开箱即用体育数据的MCP用户
C
70FMRS · B
Claudinho是一个精心设计的非官方世界杯比分MCP服务器：无密钥、离线赛程、多语言、多表面（CLI/状态栏/钩子/MCP），隐私上不收集个人数据，安全上仅stdio加两个只读出站主机。适合2026年赛事期间的球迷开发者；依赖第三方实时数据且为个人项目，赛后价值有限。
Claudinho是一个独立的开源粉丝项目（MIT许可，非FIFA或Anthropic官方），通过MCP服务器、CLI和Claude Code / Cursor状态栏提供2026年男足世界杯的实时比分、赛程和积分榜。无需API密钥或注册，全部104场比赛的赛程内置离线可用；实时数据来自ESPN公开记分板，并会在输出中注明来源。MCP服务器通过stdio传输，提供9个只读工具和 my_team / tournament_today 提示模板，支持 en/es/pt/fr 四种语言，可选时区和解说风格设置。
工具能力
get_today
获取今日比赛与比分
get_live
获取正在进行的实时比赛
get_match
按ID查询单场比赛详情
get_next_fixture
查询指定球队（如MEX）的下一场比赛
get_standings
获取小组积分榜
get_bracket
获取淘汰赛对阵树
get_market_signal
获取只读的预测市场倾向信号（来源Polymarket，仅供参考）
get_share_snippet
生成可分享的纯文本比分/积分卡
get_team
球队名称转代码（如 "DR Congo" → COD）
安装接入
通过npm分发（@claudinho/mcp）。Claude Code：安装 @claudinho/cli 后运行 claudinho init claude（会先备份 ~/.claude/settings.），或手动执行 claude mcp add claudinho -- npx -y @claudinho/mcp。Cursor：claudinho init cursor 或在 ~/.cursor/mcp. / 项目 .cursor/mcp. 中添加 {"mcpServers":{"claudinho":{"command":"npx","args":["-y","@claudinho/mcp"]}}}。Codex CLI：codex mcp add claudinho -- npx -y @claudinho/mcp。其他MCP客户端使用相同的stdio配置。重启代理会话生效。可选环境变量：CLAUDINHO_LANG（en/es/pt/fr）、CLAUDINHO_TZ（IANA时区）、CLAUDINHO_FLAVOR（off/subtle/full）、CLAUDINHO_MARKETS（off 关闭市场信号）。
claude_desktop_config.json
{"mcpServers":{"claudinho":{"command":"npx","args":["-y","@claudinho/mcp"]}}}
选型与风险
不适合谁
- 需要官方或授权赛事数据的用户（非FIFA关联项目）
- 需要写入操作或身份验证的工具场景（仅只读）
- 寻求投注建议的用户（市场信号仅供参考）
所需权限
- 本地缓存目录 ~/.cache/claudinho 的读写
- 比赛进行时对ESPN公开记分板的只读网络请求
- 市场信号开启时对Polymarket公开数据的只读请求
- 修改Claude Code / Cursor配置文件以安装状态栏和钩子
风险与副作用
- 非官方粉丝项目，数据准确性取决于第三方（ESPN、Polymarket）的可用性与质量
- 实时比分依赖网络；离线时仅内置赛程和淘汰赛结构可用
- 预测市场信号仅为信息参考，不应作为投注依据
- 单人维护的$0项目，赛事后的维护持续性不确定
常见排障
- 旗帜显示为方块字母（如CH）？终端（如Warp）不支持区域指示符组合，可用 CLAUDINHO_FLAGS=off 切换为三字码
- 状态栏未更新？重启代理会话后生效；本地开发需用 --command 指向本地构建
- Cursor的beforeSubmitSubmit钩子尚不可靠注入上下文，比分感知钩子目前仅限Claude Code
- 设置 CLAUDINHO_DEBUG=1 将数据提供方失败诊断输出到stderr
使用场景
编码任务间隙询问AI代理“XX队赢了吗”并获得实时比分
在Claude Code / Cursor状态栏内联查看正在进行的比赛比分
查询小组积分榜、淘汰赛对阵树和下一场比赛时间（支持时区）
生成纯文本比分卡分享到群聊（剪贴板复制）
支持客户端
Claude Code完整支持
Cursor CLI部分支持
Codex CLI完整支持
Claude Desktop完整支持
Windsurf完整支持
Zed完整支持
VS Code完整支持