# @claudinho/mcp 中文文档

规范地址：https://npmcn.com/package/%40claudinho/mcp/

版本：0\.13\.1
npm 元数据更新时间：2026-10-29T06:22:30.991Z
中文译文更新时间：2026-11-10T00:25:43.087Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40claudinho/mcp
原文对照：https://npmcn.com/package/%40claudinho/mcp/?lang=original
项目主页：https://github.com/arturogarrido/claudinho#readme
源码仓库：https://github.com/arturogarrido/claudinho

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：380 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-06-04T21:55:27.206Z
- 最新版本发布：2026-10-29T06:22:30.581Z
- 近 30 天下载量：1809（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

一个MCP服务器,为你们接下来的比赛配有现场足球分数,固定装置,站位和贴上准备的火柴卡:世界杯,总理联赛,LALIGA,冠军联赛等12个. 与 Claude 代码、 Cursor 、 Codex 、 Claude 桌面、 Wi 一起工作

## 安装

```sh
npm install @claudinho/mcp
```

也可以使用：`pnpm add @claudinho/mcp`、`yarn add @claudinho/mcp`、`bun add @claudinho/mcp`

## README

![The Claudinho logo: a yellow C around a football, above the word claudinho](https://raw.githubusercontent.com/arturogarrido/claudinho/main/.github/assets/logo.png)

# @claudinho/mcp ####

**一个MCP服务器,让你的编码代理 回答足球问题: 活的分数,固定, 参加你所参加比赛的比赛的预选和贴出火柴卡:世界杯,总理 联盟,LALIGA,冠军联盟和另外12个.** 它在克洛德密码,克洛德密码,克洛德密码 桌面,Windsurf,Zed,VS代码以及任何运行本地(stdio)服务器的MCP客户端. 没有 API 密钥, 没有 注册,没有账户.

![Cursor CLI asked mid-task how Manchester City are doing against Paris Saint-Germain; it calls the Claudinho MCP server and answers with the live score from the 24th minute](https://raw.githubusercontent.com/arturogarrido/claudinho/main/.github/assets/mcp-aha.gif)

## 安装

服务器运行于 `npx`所以它需要22号节点 这是最古老的线路,不是保安 级别:运行节点22或24行的补丁发布.

**克劳德代码**

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

**代码 CLI**

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

**光标、 Claude 桌面、 Windsurf、 Zed、 VS 代码**: 将此添加到客户端的 MCP 配置中( 用于 诅咒, `~/.cursor/mcp.json` 或项目 `.cursor/mcp.json`; 用于 Claude 桌面, 设置 − 开发者 — 编辑配置, 然后重新启动 。 一些客户端( VS 代码, Zed) 将相同的 `command` 财务报告和审定财务报表 `args` 在他们自己的密钥下: 参见您的客户端的 MCP 文件 .

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

也使用光标CLI? `claudinho init cursor` (从) `@claudinho/cli`将活的分数放在它的 状态行并打印此配置供您粘贴 .

## 问你的第一个问题

服务器一次回答一个比赛. 随便你问个问题

> 今天是什么样的冠军联盟比赛 "阿森纳何时在冠军联赛出场"

或者用CLI选择一次 然后问:

```bash
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`,3个字母代码,例如 `MEX`),或日期;仅提供信息 |
| `get_team` | a 世界杯足球赛国家名称或代码取自其国际足联代码、旗帜和团体(下行) |
| `list_competitions` | 支持的比赛,每个比赛的别名和每个比赛的要约,以及有效的比赛(下线) |

每个工具,但是 `get_team` 选择 `competition` (别名如: `champions-league`),以及 最受欢迎的 `tz`, (中文(简体) ), `lang` (单位:千美元)`en`, (中文(简体) ), `es`, (中文(简体) ), `pt`, (中文(简体) ), `fr`和 `flavor` (单位:千美元)`off`, (中文(简体) ), `subtle`, (中文(简体) ), `full`) (中文(简体) ). 一个没有的电话 `lang`,或者一个空的,取取服务器的 `CLAUDINHO_LANG` 当它是准确的 `en`, (中文(简体) ), `es`, (中文(简体) ), `pt` 或者说 `fr`,其他英语答案. `get_team` 采取不 `lang`,而资源在 英语.

资源: `standings://{group}`,以及 `fixtures://{date}` (捆绑的世界杯时间表). 提示 : `my_team` (你的球队的下一场比赛及其地位,你接下来的比赛)和 `tournament_today`。 。 。 .

## 预测市场概率(世界杯)

对于世界杯的比赛, `get_today`, (中文(简体) ), `get_match` (单位:千美元) `get_share_snippet` 匹配卡, a 团队的下一场比赛或一个日期,当一个可靠的Polymarket市场时,会增加一条"谁喜欢"的短线 已存在,并且 `get_market_signal` 自己读一个. **仅供参考, 不打赌建议 :** 与Polymarket的归属关系、从不联系或贸易往来的市场化百分比。 完成 火柴从不显示. `CLAUDINHO_MARKETS=off` 在服务器中 `env` 关闭短线; `get_market_signal` 仍应答.

## 评 注

工具文本中的匹配行以读者语言的短行评论结尾 (单位:千美元)`— ¡GOOOOL!`),或一队自己的集会哭出声来,当它有一个(墨西哥的) `¿Y si sí?`猫咪 `¡Goya!`, (中文(简体) ), 阿森纳的 `COYG!`) (中文(简体) ). 被推迟或取消的比赛都得不到。 评注从未出现在 结构化数据。 关小一点 `CLAUDINHO_FLAVOR=subtle` 或者说 `off` 在服务器中 `env`,或 每次呼叫时 `flavor`。 。 。 .

## 代理构建者的详细信息

**选择竞争对手.** 一个请求的竞争是它的 `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` 一个联赛赛季没有 击倒领带(总理联盟,LALIGA) `unsupported` 除了比赛之外 世界杯足球赛. 俱乐部没有 `flag`。一个匹配的 `stage` 实值 `REGULAR` 在一个联赛的赛季, `LEAGUE` 页:1 杯赛阶段, `PO` 用于季后赛,或 `OTHER` 提供商自己在 `stageLabel`。 。 。 .

**市场.** `get_today`, (中文(简体) ), `get_match` (单位:千美元) `get_share_snippet` 比赛的牌,一个球队的下一个 匹配、日期或活匹配 `marketComplete` (表或括号卡没有)和 `get_market_signal` 携带 `complete`。 。 。 . `false` 表示 可选市场读取没有完成,它与"没有信号"不相同;文本和股份 卡片,也这么说. `CLAUDINHO_MARKETS_SOURCE=fake` 给出清晰标签的无网络预览.

**过程.** Stdout只搭载了MCP协议;诊断到stderr. `CLAUDINHO_DEBUG=1` 在服务器中 `env` 打印数据提供者的故障.

## 如何运作

世界杯104个装有包裹的固定船. 每一次比赛的日程安排,每一次 活出分数,出自ESPN的公共分数板(从它得到的答案取名ESPN). 世界杯市场概率 来源于Polymarket的公共数据. 服务器只将其缓存保存在内存.

## 隐私

没有账号,没有遥测,没有分析,没有跟踪,也没有克洛丁霍服务器. 服务器询问 ESPN (和Polymarket, 对于世界杯的概率) 公共数据 没有任何关于你的附件; 这些服务 仍然看到标准请求元数据, 如您的 IP 地址, 如任何网络请求 。 写着 没有磁盘。 完全政策: [简 单](https://github.com/arturogarrido/claudinho/blob/main/PRIVACY.md)。 。 。 .

## 许可证

麻省理工学院 2026年 阿图罗·加里多 [来源和问题](https://github.com/arturogarrido/claudinho)

独立粉丝项目. 不隶属于国际足联,任何联盟,联盟或俱乐部,或Anthropic.

_观看游戏时所建._ **#维宾拉维达罗卡#** ⚽

## 常见问题

### @claudinho/mcp 是什么？

一个MCP服务器,为你们接下来的比赛配有现场足球分数,固定装置,站位和贴上准备的火柴卡:世界杯,总理联赛,LALIGA,冠军联赛等12个\. 与 Claude 代码、 Cursor 、 Codex 、 Claude 桌面、 Wi 一起工作

### 如何安装 @claudinho/mcp？

在项目目录运行 npm install @claudinho/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claudinho-mcp，可以用 npx claudinho-mcp 直接运行。

### @claudinho/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/claudinho\_\_mcp 是否存在。

### @claudinho/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @claudinho/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @claudinho/mcp 可以商用吗？

@claudinho/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @claudinho/mcp 的下载量有多少？

根据 npm 官方下载统计，@claudinho/mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,809 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @claudinho/mcp 还在维护吗？

最新版本 0\.13\.1 发布于 2026/10/29（11 天前）；至今共发布 48 个版本，其中过去 12 个月发布了 48 个；首次发布于 2026/06/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。