Claudinho MCP Server

社区

2026世界杯实时比分，直接进入你的终端与AI代理

分类: 其他第 10 / 230
Stars: ★ 31 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 4 天前
工具数: 9

70FMRS · B

Claudinho是一个精心设计的非官方世界杯比分MCP服务器：无密钥、离线赛程、多语言、多表面（CLI/状态栏/钩子/MCP），隐私上不收集个人数据，安全上仅stdio加两个只读出站主机。适合2026年赛事期间的球迷开发者；依赖第三方实时数据且为个人项目，赛后价值有限。

最强项 · 文档质量 17/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

17/20

维护活跃度

13/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: 仅能看到 server.json 清单和 README，没有实际源码、测试文件或 CI 工作流内容可供核验；README 中提到的 CI 徽章属于不可信证据，不能作为可复现证据采信。清单声明了 9 个只读工具且描述基本自洽，'happy path' 看起来是合理的，但缺乏可验证的错误处理、依赖控制和边界情况证据，因此依据静态校准规则（无可验证执行证据时可靠性不得超过 12 分）给出较低分。
安全与权限 17/20: 该服务器为纯 stdio 传输，不需要任何凭证；所有环境变量（语言、时区、风格、市场信号开关）均为可选的展示类配置，不涉及密钥或写权限。README/SECURITY.md 声明的威胁模型为'仅 stdio、无监听端口、无凭证、两个只读出站主机'，隐私政策声明不收集个人数据、无遥测。未见不可逆的删除/支付/部署/远程命令等危险默认操作，未触发红线。因未能查看实际源码以核实清单外是否存在未声明的网络调用或权限扩张，故未给满分。
维护活跃度 13/20: 项目为 MIT 许可，非 archived 状态，具备 CI 徽章、npm 出处（OIDC 可信发布）和独立的安全披露渠道（GitHub Security Advisories）。但版本号为 0.9.4，处于 1.0 之前的阶段性版本，且 README 明确自称是'solo, $0, organic fan project'（单人维护），治理与版本演进存在明显缺口，因此评分居中。
文档质量 17/20: README 内容详尽，覆盖安装（CLI/Cursor/Claude Code/其他 MCP 客户端）、环境变量说明、FAQ、离线/在线数据边界、已知终端渲染问题的排查、隐私政策与安全政策链接，且工具列表与清单中的 9 个工具名称一致。扣分点在于缺少每个工具的具体参数 schema 说明，以及'速率限制'等表述较为笼统，未给出具体数值或配额说明。
安装易用性 14/20: 安装路径非常清晰：提供 npx 一行命令、claude mcp add / codex mcp add 命令，以及适用于多个客户端（Cursor、Claude Desktop、Windsurf、Zed、VS Code）的标准 stdio JSON 配置示例，步骤少且有清晰的多客户端示例。但根据静态校准要求，在没有可验证执行证据（真实 CI 工作流与覆盖关键路径的已提交测试）的情况下，安装易用性分数不得超过 15 分，故在该上限内给出较高但受限的分数。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

比赛期间在终端工作、想随时掌握比分的开发者
使用Claude Code或Cursor CLI并想要足球状态栏的用户
需要无密钥、开箱即用体育数据的MCP用户

不适合谁

需要官方或授权赛事数据的用户（非FIFA关联项目）
需要写入操作或身份验证的工具场景（仅只读）
寻求投注建议的用户（市场信号仅供参考）

所需权限

本地缓存目录 ~/.cache/claudinho 的读写
比赛进行时对ESPN公开记分板的只读网络请求
市场信号开启时对Polymarket公开数据的只读请求
修改Claude Code / Cursor配置文件以安装状态栏和钩子

风险与副作用

非官方粉丝项目，数据准确性取决于第三方（ESPN、Polymarket）的可用性与质量
实时比分依赖网络；离线时仅内置赛程和淘汰赛结构可用
预测市场信号仅为信息参考，不应作为投注依据
单人维护的$0项目，赛事后的维护持续性不确定

安装接入

准备工作

运行环境：Node.js

其他可选配置项（8 个）

CLAUDINHO_LANG 可选输出语言：en、es、pt 或 fr，可选，默认 en。

CLAUDINHO_TZ 可选 IANA 时区，如 America/Mexico_City，用于开球时间显示，可选。

CLAUDINHO_FLAVOR 可选解说风格：off、subtle 或 full，可选，默认 full。

CLAUDINHO_MARKETS 可选设为 off 可隐藏预测市场信号（仅供信息参考），可选。

CLAUDINHO_TEAM 可选限定只关注某支球队（如 MEX），CLI/状态栏环境变量，可选。

CLAUDINHO_FLAGS 可选设为 off 用三字代码替代旗帜 emoji，on 强制显示旗帜，可选。

CLAUDINHO_CURSOR_META 可选设为 auto 可在 Cursor 状态栏分数下方显示模型与上下文行，可选。

CLAUDINHO_DEBUG 可选设为 1 时向 stderr 输出数据源故障诊断信息，可选。

通过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 关闭市场信号）。

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端 MCP 配置中添加 {"mcpServers":{"claudinho":{"command":"npx","args":["-y","@claudinho/mcp"]}}} 后重启会话，工具列表中应出现 get_today、get_live 等 9 个工具；询问“今天的比赛”即可验证连接。

常见排障

旗帜显示为方块字母（如CH）？终端（如Warp）不支持区域指示符组合，可用 CLAUDINHO_FLAGS=off 切换为三字码
状态栏未更新？重启代理会话后生效；本地开发需用 --command 指向本地构建
Cursor的beforeSubmitSubmit钩子尚不可靠注入上下文，比分感知钩子目前仅限Claude Code
设置 CLAUDINHO_DEBUG=1 将数据提供方失败诊断输出到stderr

试试这样问

连接成功后，可以直接对 AI 助手这样说：

今天的比赛有哪些？比分是多少？
现在有正在进行的比赛吗？
德国出线了吗？给我看淘汰赛对阵图。
墨西哥下一场比赛是什么时候？

工具能力 9

get_today 只读

获取今日比赛与比分

get_live 只读

获取正在进行的实时比赛

get_match 只读

按ID查询单场比赛详情

get_next_fixture 只读

查询指定球队（如MEX）的下一场比赛

get_standings 只读

获取小组积分榜

get_bracket 只读

获取淘汰赛对阵树

get_market_signal 只读

获取只读的预测市场倾向信号（来源Polymarket，仅供参考）

get_share_snippet 只读

生成可分享的纯文本比分/积分卡

展开其余 1 个工具

get_team 只读

球队名称转代码（如 "DR Congo" → COD）

使用场景

编码任务间隙询问AI代理“XX队赢了吗”并获得实时比分

在Claude Code / Cursor状态栏内联查看正在进行的比赛比分

查询小组积分榜、淘汰赛对阵树和下一场比赛时间（支持时区）

生成纯文本比分卡分享到群聊（剪贴板复制）

支持客户端

Claude Code

Cursor CLI部分支持

Codex

Claude Desktop

Windsurf

Zed

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Claudinho是一个独立的开源粉丝项目（MIT许可，非FIFA或Anthropic官方），通过MCP服务器、CLI和Claude Code / Cursor状态栏提供2026年男足世界杯的实时比分、赛程和积分榜。无需API密钥或注册，全部104场比赛的赛程内置离线可用；实时数据来自ESPN公开记分板，并会在输出中注明来源。MCP服务器通过stdio传输，提供9个只读工具和 my_team / tournament_today 提示模板，支持 en/es/pt/fr 四种语言，可选时区和解说风格设置。