Mtg Commander MCP

MTG指挥官MCP服务器

Magic的模型上下文协议（MCP）服务器：收集指挥官/EDH。在7个数据源中提供19个工具，用于卡片查找、卡片组构建、价格比较、规则参考和个人收藏工作流程。

数据源

工具

EDHRec

• edhrec_commander_recommendations -按类别列出指挥官的最佳卡片，包括协同得分和包含率。支持主题过滤。
• edhrec_commander_combos -带有结果、受欢迎程度百分比和括号数据的热门组合。
• edhrec_commander_themes -可用的原型/主题，包括蛞蝓和甲板数量。
• edhrec_top_cards -按时间段（年/月/周）列出的顶级EDH卡。
• edhrec_search_commanders -按颜色标识浏览指挥官。

Scryfall

• scryfall_card -完整的卡片数据，包括甲骨文、法力成本、类型、合法性、定价和图像。处理双面和拆分卡。
• scryfall_search -使用搜索 Scryfall语法 （例如。 c:ug type:creature cmc<=3).
• scryfall_rulings -官方对卡片的裁决。

甲板工具

• import_deck -从Archidekt或Moxfield URL导入甲板。
• analyze_deck -导入并分析一副牌：法力曲线、颜色分布、类型分解、法力库评估和基于EDHRec的牌建议。
• build_deck -从一张牌名构建一个完整的100张牌指挥官牌组。支持预算层级和主题过滤。如果卡片不是指挥官，建议使用它的指挥官。

定价

• price_deck -在TCGPlayer和Card Kingdom上为Archidekt/Moxfield的一副牌定价。将总成本和卡可用性与建议进行比较。使用Scryfall的批次 /cards/collection 端点加上8路并发EDHRec查找，因此100张卡的价格通常在10-20秒内（低于早期版本的2-3分钟）。注意：一副满是边缘案例打印的卡片可能会产生一个短暂的请求突发，短暂地触发Scryfall的每IP速率限制器；如果是Scryfall支持的后续工具(scryfall_card, scryfall_search, scryfall_rulings)退货 "Scryfall rate limit exceeded after retries"，等待约30秒，然后重试。（用于放大这一点的内部油门座圈在0.2.0中是固定的。）
• refresh_pricing_data -刷新本地MTGJSON定价缓存（约132 MB每日价格快照+约150 MB标识符映射）。安装后致电一次，快速购买清单定价；后续调用会在过时时自动刷新。首次下载约60-90秒，每日刷新约30秒。
• pricing_cache_status -MTGJSON缓存状态的只读检查（大小、年龄、新鲜度标志）。

收藏（Delver镜头）

• import_collection -从Delver Lens CSV导出或任何兼容的预设（Moxfield、TCGPlayer、Deckbox、MTGstand）导入Magic系列。接受本地文件路径、http://URL或粘贴的CSV文本。自动检测列变量（名称/卡片名称、数量/计数、设置代码/版本、箔片/打印、拼字球ID）。通过Scryfall解析名称（更喜欢 scryfall_id 当存在时）。通过 persist=True 将其他收集工具作为活动收集存储在磁盘上。
• collection_summary -活跃收藏的统计数据：唯一卡片、总数量、估计美元价值（TCGPlayer）、颜色识别细分和顶级套装。
• compute_card_allocation -给定一个Archidekt/Moxfield deck URL列表（和/或用于自动发现的Archidekt用户名），显示 committed 现有甲板vs free 使用和标志 over_committed 卡片（使用的套牌比你拥有的多）。
• pull_and_buy_lists -标题工作流工具。给定一个新的甲板（URL或粘贴的甲板列表）加上现有的甲板，返回 拉取列表 （卡片要从 *自由* 您的收藏池）和定价 购买清单 （TCGPlayer USD）其余部分。默认跳过基本区域(include_basics=True 包括他们）。

为什么选择CSV？

mtg.delver.dev/collection 是一个Firebase-authed单页应用程序-没有公共API，仪表板URL不可共享。Delver的文件化、稳定的导出表面是CSV（或专有 .dlens SQLite备份；目前不支持）。要使用收集工具，请执行以下操作：

1. 在Delver Lens或web应用程序中，将您的收藏导出为CSV。
2. 选择一个预设（Delver原生、Moxfield、TCGPlayer、Deckbox或MTGstand中的任何一个都会自动检测）。
3. 将文件路径/URL/粘贴的文本传递给 import_collection(source=..., persist=True).

规则

• mtg_rules -按关键字或规则编号搜索MTG综合规则。涵盖3100多条规则和730多个术语表条目。向导发布新规则时自动更新。

安装

需要 紫外线:

git clone https://github.com/GrooGruxKing27/mtg-commander-MCP.git
cd mtg-commander-MCP
uv sync

Claude桌面设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mtg-commander": {
      "command": "/absolute/path/to/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/mtg-commander-MCP",
        "--no-editable",
        "mtg-commander-mcp"
      ]
    }
  }
}

使用绝对路径 uv （找到它 which uv)--Claude Desktop不继承您的shell PATHThe --no-editable 旗帜侧移a ModuleNotFoundError 由可编辑安装引起 .pth Python 3.14下的文件。

重新启动Claude Desktop以获取新服务器。

Claude代码设置

添加到您的克劳德代码设置或 .claude/settings.json:

{
  "mcpServers": {
    "mtg-commander": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/mtg-commander-MCP",
        "--no-editable",
        "mtg-commander-mcp"
      ]
    }
  }
}

故障排除

• ModuleNotFoundError: No module named 'mtg_commander_mcp' --确保 --no-editable 在args中（见上文）。Python 3.14打破了依赖于 .pth 文件夹。
• Operation not permitted 启动时 --如果您的配置调用了shell脚本包装器（例如。 run.sh)里面住着 ~/Documents，macOS TCC将阻止沙盒克劳德桌面执行它。使用 uv run 直接命令，如上所示，或将repo移到外部 ~/Documents （例如。 ~/src/).

测试

运行MCP检查器：

uv run mcp dev src/mtg_commander_mcp/server.py

预算层级（build_deck）

颜色识别过滤器（edhrec_search_commands）

单声道： white, blue, black, red, green, colorless

两种颜色： azorius, dimir, rakdos, gruul, selesnya, orzhov, izzet, golgari, boros, simic

三种颜色： esper, grixis, jund, naya, bant, abzan, jeskai, sultai, mardu, temur

五种颜色： five-color

依赖项

• mcp[cli] -模型上下文协议SDK
• httpx -异步HTTP客户端
• cloudscraper -Moxfield的Cloudflare旁路

许可证

麻省理工学院.另见 CHANGELOG.md 发布说明。