Liga Record MCP

一个 MCP 服务器，将我的 Liga Record 梦幻足球队 暴露给 Claude——规则作为工具，规章作为资源，以及两个用于我每轮实际决策的提示词。

它所基于的划分是：确定性规则存在于代码中，判断力留给 Claude。 阵型合法性、预算计算和 §11 自动换人都在这里计算，并且具有权威性。 谁首发、谁出售，则由 Claude 基于真实数据和真实规则手册来推理。

设计以及本规则解读所遗留的规则歧义，请参阅 docs/PLANNING.md。

安装

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

可编辑安装不是可选的——它将 liga_record_mcp 放入路径（项目使用 src/ 布局），并创建 MCP 配置所指向的 liga-record-mcp 启动器。

你的球队名单存放在 data/squad.yaml 中。复制 data/squad.example.yaml 并填入 你的 23 名球员——加载器每次读取时都会对照规章检查文件，并指出缺少什么， 这样你就不必手动清点。将 LIGA_RECORD_SQUAD 指向另一个文件即可运行第二支球队。

Related MCP server: wcprediction-mcp

连接到 Claude

仓库根目录中的 .mcp.json 已经声明了服务器，因此当你打开此项目时， Claude Code 会自动拾取它——无需 CLI。安装后重启 Claude Code，并在提示时批准该服务器。

.mcp.json 中的路径是绝对路径，且因机器而异。 Windows 会将相对命令解析为 相对于启动进程的目录，而不是服务器的目录，因此当应用启动它时，相对路径会失败。 如果你移动或克隆仓库，请编辑该路径。

Claude Desktop 在 claude_desktop_config.json 中使用相同的结构：

{
  "mcpServers": {
    "liga-record": {
      "command": "C:\\path\\to\\liga-record-mcp\\.venv\\Scripts\\liga-record-mcp.exe"
    }
  }
}

然后问它一些问题："我当前的首发十一人合法吗？如果 Diogo Costa 不上场，谁会替补上场？"

它暴露了什么

工具 — get_squad、get_player、search_squad、validate_selection、 simulate_autosubs、check_transfer、project_price，以及两个读取实时网站的： search_market（整个球员池，带所有权百分比，用于寻找差异化球员）和 check_market_transfer（根据真实报价而非手输价格来定价一笔交易）。每次读取都带有 as_of 时间戳，以便 Claude 能说明数据的时效性，而不是将存储的球队名单呈现为实时数据。

实时客户端在设计上只读。该网站还暴露了买入、卖出和续约端点——它们的契约是已知的—— 但刻意未实现。确认交易仍然由人类在 Record 网站上点击完成。

资源 — ligarecord://regulamento（由规则所执行的相同常量生成，因此不会与代码 产生偏差）和 ligarecord://squad。

提示词 — pick_starting_xi、plan_transfers。

测试

./.venv/Scripts/python.exe -m pytest -q

rules.py 是纯函数——无 I/O、无网络、无时钟——因此整个规则手册都可以在不接触 网站的情况下进行测试。

状态

步骤 1–3 已完成：规则引擎、带手工维护的 YAML 球队名单的数据源接缝，以及 MCP 服务器。

步骤 4 完成了一半，而最重要的一半正是已交付的那一半。 playersearch.ashx 为整个 498 名球员的市场返回干净的 JSON，并且无需身份验证—— 已通过一个不带 cookie 的请求验证——因此计划中视为步骤 4 主要风险的会话令牌问题 对于市场数据根本不存在。

读取特定球队的名单仍然需要登录，因此 data/squad.yaml 仍然需要手工维护。 这是剩余的部分。