使用说明
Mystic Tutor MCP
Magic: The Gathering card data at your AI's fingertips
A Model Context Protocol server that gives Claude (or any MCP client) real-time access to Magic: The Gathering card data, prices, rulings, synergies, and more — powered by the Scryfall API.
它能做什么?
| 工具 | 说明 |
|---|---|
get_card |
按名字查找任何卡片(模糊匹配)。返回mana成本、oracle文本、价格、合法性等。 |
search_cards |
满 Scryfall搜索语法 --按类型、颜色、CMC、关键字、集合等查找卡片。 |
get_card_rulings |
WotC对任何卡的官方裁决。 |
find_synergies |
智能协同查找器——分析卡片的机制,并使用Scryfall的社区标签查找补充卡片。 |
find_similar |
按功能、统计数据、类型或整体特征查找类似的卡片。 |
快速开始
克劳德代码
claude mcp add --transport stdio mystic-tutor -- npx mystic-tutor-mcp
就是这样。重新启动Claude Code并开始询问卡片。
克劳德桌面版
添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mystic-tutor": {
"command": "npx",
"args": ["-y", "mystic-tutor-mcp"]
}
}
}
来源
git clone https://github.com/Abbabon/mystic-tutor-mcp.git
cd mystic-tutor-mcp
npm install && npm run build && npm link
claude mcp add --transport stdio mystic-tutor -- npx mystic-tutor-mcp
例子
卡片查询
你: 韵律学是做什么的,它有多少钱?
## Rhystic Study
Mana Cost: {2}{U} | CMC: 3
Type: Enchantment
Oracle Text: Whenever an opponent casts a spell, you may draw a card
unless that player pays {1}.
Prices: USD $6.50 | Foil $7.99
Legalities: Commander: legal | Legacy: legal | Modern: not_legal
EDHREC Rank: 3
Scryfall搜索
你: 给我找些在现代合法的带闪光灯的廉价绿色生物
该工具运行: search_cards 带查询 t:creature c:green keyword:flash f:modern 按价格排序。
协同效应
你: 苏泰的颜色与加倍季节有什么协同作用?
工具检测 令牌 和 计数器 主题,然后搜索:
otag:synergy-tokens ci<=BUG f:commanderotag:counters-matter ci<=BUG f:commander
返回按主题分组的顶级协同卡。
类似卡片
你: 哪些卡片与闪电螺栓相似?
该工具分解了闪电螺栓的机制(o:"deals" o:"damage", t:instant, mv=1)并发现了类似的燃烧法术。
裁决
你: 对Panharmonicon的裁决是什么?
返回卡片的甲骨文文本以及所有带有日期的官方WotC裁决。
检查产品价格
你: [这个秘密巢穴]里的牌值多少钱?
Claude获取产品页面,提取卡片名称,然后调用 get_card 将每张卡的总价值与产品价格进行比较。
运作原理
Claude ←→ stdio ←→ Mystic Tutor MCP ←→ Scryfall API
- 运输:stdio(标准MCP协议)
- 数据源: API公司 (免费,不需要API密钥)
- 速率限制:Scryfall请求之间的最小间隔为100ms(根据他们的指导方针)
- 协同引擎:使用Scryfall的
otag:社区协同标签+oracle文本模式分析 - 响应格式:针对LLM消费优化的结构化文本
需求
- Node.js 18+
- MCP兼容客户端(Claude Code、Claude Desktop或任何MCP客户端)
路线图
- []甲板解析和分析(mana曲线、颜色分布)
- []捆绑式综合规则(
lookup_rule,search_rules) - []EDHREC整合指挥官建议
- []不同印刷品的价格比较
- []用于重复查找的内存缓存
学分
- 卡数据由 Scryfall
- 与 模型上下文协议SDK
- 受...启发 鸭肉/味精 和 埃及/mtg-mcp
- 标题艺术: 神秘导师 Lindsey Look
许可证
麻省理工学院