mcpField
C
Comunio

Comunio

本地服务
github.com游戏娱乐12 周前更新
代码仓库访问官网

关于 Comunio

Comunio 是面向 Comunio fantasy football 玩家和 AI 助手的 MCP 服务，可读取联赛数据并代为操作球队。它将 Comunio 的非官方 API 转为读写工具，并将写操作交由客户端审批。

主要功能

  1. 01查询阵容、市场、报价和排名
  2. 02查看转会记录
  3. 03出价与接受报价
  4. 04设置球队阵容
  5. 05写操作由客户端请求确认

适用场景

  1. 01检查球队阵容和联赛排名
  2. 02查看市场并提交球员报价
  3. 03接受报价或调整比赛阵容

MCP 相关

该 MCP 服务向客户端提供查询球队、市场、报价、排名和转会的工具，也提供出价、接受报价及设置阵容等写操作。写操作会标记为变更操作，以便客户端先请求确认。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "josetorronteras-comunio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COMUNIO_USERNAME",
        "-e",
        "COMUNIO_PASSWORD",
        "-e",
        "COMUNIO_TIMEZONE",
        "-e",
        "COMUNIO_USER_AGENT",
        "ghcr.io/josetorronteras/comunio-mcp:1.0.2"
      ],
      "env": {
        "COMUNIO_USERNAME": "<COMUNIO_USERNAME>",
        "COMUNIO_PASSWORD": "<COMUNIO_PASSWORD>",
        "COMUNIO_TIMEZONE": "<COMUNIO_TIMEZONE>",
        "COMUNIO_USER_AGENT": "<COMUNIO_USER_AGENT>"
      }
    }
  }
}
启动命令docker run -i --rm -e COMUNIO_USERNAME -e COMUNIO_PASSWORD -e COMUNIO_TIMEZONE -e COMUNIO_USER_AGENT ghcr.io/josetorronteras/comunio-mcp:1.0.2
需要配置的环境变量
COMUNIO_USERNAMEEmail or username of the Comunio account the server acts for.
COMUNIO_PASSWORD密钥Password of that Comunio account.
COMUNIO_TIMEZONEIANA timezone used for the x-timezone header and the login offset. Defaults to Europe/Madrid.
COMUNIO_USER_AGENTOverrides the browser user agent sent to Comunio. Only needed if the API starts refusing the default.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/josetorronteras/comunio-mcp:1.0.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Comunio MCP

CI codecov MCP Registry License: MIT

一个用于 Comunio 的 MCP（Model Context Protocol）服务。Comunio 是一款在线足球梦幻经理游戏。

它让 AI 助手能够访问你的联赛信息——球队阵容、市场、报价、排名和转会——并代表你采取行动：出价、出售球员、设置阵容。只需一行，client ↔ MCP ↔ Comunio，其中 MCP 就是中间部分。

状态：每天都在真实账号上使用。共有 19 个工具：读取球队阵容、市场、报价、排名和转会，以及操作市场、出价和阵容。它使用的是 Comunio 的非官方 API，该 API 可能随时变更，恕不另行通知——请参阅 docs/comunio-api.md，了解已映射和未映射的内容。

工作原理

工具分为两类，名称会告诉你它属于哪一类：

类型命名功能
读取get_squad、get_market、get_offers仅查询，不会更改任何内容，始终安全。
写入place_bid、accept_offer、set_lineup更改你的球队或花费你的资金。

由此可见两个特点：

**此服务内部没有 AI 模型，也没有策略。**它只负责转换：让 Comunio 的 API 可供调用，并让其响应易于理解——解析球员位置编号、同一个端点表示“无数据”的五种不同方式，以及每一行都为 0 的排名字段。该买哪名球员，由你正在使用的助手来决定。不需要 API 密钥、GPU，也没有推理成本。

**客户端会在执行操作前征求你的同意。**每个会修改数据的工具都会明确标记为写入操作，因此你的 MCP 客户端会先停下来征求你的同意。你同意后，服务不会再对操作进行二次判断，而是如实报告 Comunio 的实际响应，不会擅自认定操作成功。

要求

  • Docker。
  • 一个 Comunio 账号。不需要 API 密钥，也无需注册——服务会以你的身份登录。

主机上无需安装其他任何内容。

快速开始

镜像已发布，因此无需克隆，也无需构建。将凭据放在只有你能读取的文件中，而不是放在 shell 会记住的命令里：

install -m 600 /dev/null ~/.comunio.env
$EDITOR ~/.comunio.env      # COMUNIO_USERNAME=you
                            # COMUNIO_PASSWORD=...

claude mcp add comunio -- docker run -i --rm \
  --env-file "$HOME/.comunio.env" \
  ghcr.io/josetorronteras/comunio-mcp

然后询问助手你的球队近况如何——get_account 是验证凭据是否有效的最快方式。

有关 Claude Desktop、完全跳过 Docker 的 uvx 方式，以及各个变量的用途，请参阅 docs/setup.md。

文档

  • 设置 — 运行镜像并将其连接到 MCP 客户端
  • 工具 — 各个工具会返回什么，以及会影响哪些内容
  • 开发 — 项目结构、开发命令和 SDK 注意事项
  • 架构 — 设计决策及其背后的理由
  • Comunio API — 身份验证、链接索引以及尚未映射的内容
  • MCP 协议说明 — 影响本项目的 MCP 2026-07-28 部分
  • 更新日志 — 各版本的变更内容

参与贡献

欢迎提交问题和拉取请求。CONTRIBUTING.md 介绍了环境设置、服务应包含和不应包含的内容，以及不可妥协的规则——提交中不得包含凭据、令牌或真实账号数据。漏洞请通过 SECURITY.md 报告，不要公开提交问题。

版本管理

发布遵循语义化版本，其涵盖范围是 MCP 接口：工具名称、输入架构以及响应包含的字段。重命名工具、删除参数或移除响应中的字段都属于主版本变更。添加工具、可选参数或字段则属于次版本变更。

语义化版本无法涵盖 Comunio 本身。本项目使用的是非官方 API，该 API 可能在不另行通知的情况下发生变化或中断，任何版本号都无法对此作出保证。API 发生变化时，修复将以补丁版本或次版本发布，工具的结构保持不变。

许可证

MIT。

免责声明

本项目为非官方项目，与 Comunio 无关联。请使用自己的账户，并自行承担风险。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。