Squadcard

面向 AI Agent 的 Squadcard

Squadcard 是一款面向每周踢球的足球群组的应用：谁参加、公平分队，以及队友评分。 此文件夹包含 Agent 使用它所需的内容。完整指南：https://squadcard.app/agents

一个 MCP 服务，无需安装：https://squadcard.app/api/mcp。你只需在浏览器中登录一次 Squadcard；之后，Agent 就可以：

• 根据名单公平地分成两队
• 制定循环赛赛程表
• 推荐球队名称
• 创建球队并提供邀请链接
• 通过你提供的邀请链接加入球队
• 表明你下场比赛参加、待定或缺席
• 安排本周的比赛，并告诉你谁会参加
• 确定球队、录入比分并提供投票链接

它绝不会看到任何人的投票、标记付款、购买任何东西、移除球员或删除任何内容。

MCP 配置

适用于接受 JSON 配置的客户端（Claude Desktop、Cursor、VS Code 等）：

{
  "mcpServers": {
    "squadcard": {
      "type": "http",
      "url": "https://squadcard.app/api/mcp"
    }
  }
}

首次使用工具时，浏览器会打开，让你登录 Squadcard。

工具

• make_fair_teams：根据名单公平地分成两支实力均衡的球队，并将守门员分开
• make_fixtures：为 3 到 16 支球队制定循环赛赛程表
• suggest_team_names：根据主题或词语推荐球队名称
• list_squads：列出已登录用户的球队
• get_squad：获取球队信息、邀请链接、下一场比赛及参加人员
• create_squad：创建球队，由你担任组织者
• join_squad：通过你提供的邀请链接加入球队
• set_game：设置球队比赛的时间和地点
• answer_game：表明你下场比赛参加、待定或缺席
• pick_teams：根据确认参加的人员分成实力均衡的球队
• reshuffle_teams：将同一批球员再次公平分队
• enter_result：保存比分并开启投票，然后获取投票链接
• get_match：获取比赛、球队、比分及出勤情况

Claude Code

claude mcp add --transport http squadcard https://squadcard.app/api/mcp

然后选择 /mcp → squadcard → 登录。

也可以安装插件，它会添加 MCP 服务和一项技能，告诉 Claude 如何使用它。在 Claude Code 中：

/plugin marketplace add iuliczki/squadcard-agents
/plugin install squadcard@squadcard

Codex

codex mcp add squadcard --url https://squadcard.app/api/mcp
codex mcp login squadcard

Agent 运行环境中没有浏览器？

在 https://squadcard.app/account 的“AI agents”下创建密钥，并将其作为 Authorization: Bearer <key> 发送（codex/config.toml 展示了 Codex 的配置方法）。密钥与登录具有相同的权限限制；你也可以在同一页面断开连接。

此仓库包含的内容

• plugins/squadcard/：Claude Code 插件（MCP 服务、一项技能、自带的 README 和许可证）
• .claude-plugin/marketplace.json：允许 Claude Code 从此仓库安装插件
• codex/config.toml：供 Codex 使用的同一 MCP 服务
• server.json：MCP 注册表条目

MIT 许可证。