使用说明
MTG-MCP
Magic：收集模型上下文协议服务器
一个全面的模型上下文协议（MCP）服务器，为AI助手提供丰富的Magic:The Gathering信息，包括卡数据、全面规则、EDHREC建议、组合交互和智能指挥官牌组生成。
快速链接
概述
MTG-MCP集成了多个Magic:The Gathering数据源，为AI助手提供权威信息，用于回答问题、提出建议和生成合法指挥官名单。服务器利用官方综合规则、Scryfall卡数据库、EDHREC统计数据和Commander Spellbook组合数据。
特性
核心信息工具
- 综合规则访问：按章节或关键字查询官方《魔术：聚会》综合规则
- 卡信息：检索详细的卡片数据，包括类型、法力值、甲骨文和合法性
- 卡片裁决：访问Scryfall的官方卡裁决和澄清
- 卡类型信息：获取有关卡类型、子类型和超类型的详细信息
指挥官专用工具
- 指挥官格式上下文：关于指挥官/EDH格式规则、甲板结构和游戏玩法的全面信息
- EDHREC集成：根据EDHREC数据，为任何指挥官提取顶部推荐的卡片
- 综合搜寻：从指挥官拼写本中查找卡片组合和交互
- 支架系统：带详细标准和指南的Access Commander功率级支架（1-5）
- 动态游戏改变者列表：自动更新影响牌组功率水平的高影响牌列表
- 动态禁止列表：实时指挥官禁止来自Scryfall的卡片列表
甲板生成和导入
- 指挥官甲板验证：验证指挥官的合法性，包括合作伙伴规则（合作伙伴、合作伙伴、选择背景、永远的朋友、医生的伴侣）
- [高度实验性]甲板生成：根据以下内容生成完整的100张指挥官牌组列表：
- EDHREC建议
- 目标功率级别支架（1-5）
- 指挥官颜色身份限制
- 甲板组合最佳实践
- 组合协同效应
- 甲板进口：从流行的甲板建造平台获取和分析甲板：
- 莫克斯菲尔德：导入具有自动指挥官检测功能的甲板
- 建筑师：导入具有类别组织的甲板
- 导出格式：以与Moxfield、Archidekt和其他甲板构建工具兼容的标准格式生成甲板列表
安装
有关详细的安装说明和故障排除，请参阅 安装指南.
快速入门（推荐）
直接从PyPI安装：
pip install mtg-mcp
或使用 uv:
uv pip install mtg-mcp
开发安装
有关开发或使用最新未发布的功能，请参阅 开发安装部分 在《安装指南》中。
用法
有关完整的使用说明和配置示例，请参阅 配置指南.
作为独立服务器运行
安装后，您可以直接运行服务器：
mtg-mcp
对于调试日志记录：
mtg-mcp --debug
MCP客户端集成
常见MCP客户端的配置示例：
- 克劳德桌面 -桌面AI助手
- VS代码与Cline -代码编辑器集成
请参阅 配置指南 有关详细的设置说明和故障排除。
可用工具
有关包含参数、返回类型和示例的完整API文档，请参阅 工具文档.
服务器公开了以下MCP工具：
mtg-context-get：获取MTG游戏的基本信息mtg-context-commander：获取全面的Commander/EDH格式规则mtg-cardtypes-get：获取详细的卡类型信息mtg-rules-get：获取全面规则的概述mtg-rules-search：按部分或关键字搜索规则mtg-ruling-search：搜索官方卡规则mtg-combos-search：在Commander中搜索卡片组合mtg-commander-recommend：获取EDHREC对指挥官的建议mtg-commander-brackets：获取Commander括号信息mtg-export-format：获取甲板导出格式指南mtg-commander-deck：验证指挥官并生成甲板数据mtg-archidekt-fetch：从Archidekt获取甲板数据mtg-moxfield-fetch：从Moxfield获取甲板数据（具有自动指挥官检测功能）
例子
有关更多示例和详细的使用模式，请参阅 快速入门指南 和 工具文档.
打造有竞争力的EDH平台
Use #mtg-commander-deck to generate a Bracket 5 (cEDH) commander deck with Tymna the Weaver and Kraum, Ludevic's Opus.
生成一个休闲指挥官甲板
Use #mtg-commander-deck to create a Bracket 2 casual deck with Atraxa, Praetors' Voice.
搜索卡裁决
Use #mtg-ruling-search to find rulings for Doubling Season.
查找指挥官建议
Use #mtg-commander-recommend to get the top cards for Kinnan, Bonder Prodigy.
搜索组合
Use #mtg-combos-search to find combos with Thassa's Oracle.
数据源
- API公司：卡数据、裁决和合法性信息
- EDHREC：指挥官建议和甲板统计
- 指挥官拼写手册：组合互动和协同作用
- MTG-SDK：卡类型和子类型
- 威世智：官方综合规则和禁止名单
- 建筑师：甲板导入
- 莫克斯菲尔德：甲板导入
发展
运行测试
pytest
代码质量
该项目使用Ruff进行linting和格式化：
ruff check .
ruff format .
支架系统
MTG-MCP包括对指挥官支架系统的支持（1-5）。有关详细的括号标准和指南，请参阅 工具文档-指挥官支架.
- 支架1：休闲/展览-预算友好，主题游戏
- 支架2：以核心为中心的策略，配有一些强大的卡片
- 支架3：升级-优化了带有强大卡片和组合的套牌
- 支架4：优化-经过大量导师和快速法力的高度调整
- 支架5：竞争性EDH（cEDH）-最大化优化
牌组生成器在选择卡片和构建策略时遵守支架规格。
导出格式
有关完整的导出格式规范和示例，请参阅 工具文档-导出格式.
生成的甲板列表遵循与Moxfield和Archidekt等流行甲板构建工具兼容的标准格式。
贡献
欢迎投稿！请随时提交问题或拉取请求。
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
致谢
- 综合卡数据Scryfall API
- EDHREC为指挥官提供建议和统计数据
- 组合数据库的指挥官拼写手册
- 海岸魔术奇才：聚会
免责声明
MTG-MCP是粉丝内容政策允许的非官方粉丝内容。未经海岸奇才队批准/认可。使用的部分材料是海岸奇才队的财产。©海岸奇才有限责任公司。
