使用说明
Scryfall MCP服务器
一个模型上下文协议(MCP)服务器,用于查询Magic:The Gathering card information from Scryfall API,并提供增强的自然语言支持。
Natural Langauge部分需要改进,以更好地帮助LLM与Scryfall进行沟通,并将在使用时进行更新。
示例查询
I'd liek to know which are the most valuable types of triggers in MTG based on the MCP to value
特性
🎯 自然语言搜索
- 智能翻译:自动将自然语言查询(如“牺牲的红色生物”)转换为正确的Scryfall语法
- 后备支援:如果精确查询失败,常规搜索工具会自动尝试自然语言翻译
- 综合映射:支持数百个常见的MTG术语和短语
- MTG知识整合:利用全面的MTG术语数据库更好地理解
🧠 MTG知识库
- 综合术语:内置卡片类型、关键字能力、颜色组合、格式和套牌原型知识
- 情境感知建议:提供相关的MTG信息和相关的搜索建议
- 教育支持:通过详细的解释和示例了解MTG概念
- 智能术语识别:自动识别和解释查询中的MTG术语
🔍 搜索功能
- 卡片搜索:使用精确的Scryfall语法或自然语言查找卡片
- 命名卡查找:通过精确或模糊的名称匹配获取特定卡片
- 随机卡片:获取具有可选过滤功能的随机卡片
- 自动完成:获取卡片名称建议
- 高级过滤:按类型、颜色、设置、格式合法性、价格等过滤
💰 定价整合
- TCG玩家价格:TCGPlayer的详细定价
- 卡王国价格:来自卡王国的定价信息
- 多个价格点:市场、低、中、高和直接价格
- 综合定价:从多个来源获取带有定价的卡信息
教育工具
- 搜索帮助:Scryfall搜索语法的全面文档
- 翻译帮助:了解自然语言如何映射到Scryfall语法
- MTG知识查找:获取有关任何MTG术语或概念的详细信息
- 例子:复杂查询的大量示例
自然语言示例
服务器可以理解和翻译以下查询:
- “会飞的红色生物” →
c:r t:creature o:flying - “廉价的蓝色计数器” →
c:u o:"counter" and o:"spell" cmc<=2 - “进入战场的天使” →
t:angel o:"enters the battlefield" - “牺牲出口” →
o:"sacrifice" or o:"sac a" or o:"sac an" - “昂贵的现代法律卡” →
legal:modern usd>=50 - “令牌生成器” →
o:"create" and o:"token"
可用工具
主要搜索工具
scryfall_natural_search-使用自然语言搜索(推荐)scryfall_search_cards-使用NL回退的传统Scryfall语法搜索scryfall_get_card_named-按名称查找特定卡片
实用工具
scryfall_translation_help-学习自然语言映射scryfall_search_help-完整的Scryfall语法文档scryfall_autocomplete-获取卡片名称建议mtg_knowledge_lookup-全面的MTG术语和规则参考
专用工具
scryfall_get_random_card-随机卡生成器scryfall_card_with_all_prices-具有综合定价的卡信息scryfall_get_all_cards_in_set-浏览整套scryfall_get_cards_by_type-按生物类型、卡片类型等过滤。scryfall_get_cards_with_text-按oracle文本或名称搜索
安装
npm install
npm run build
用法
这是一个设计用于MCP兼容客户端的MCP服务器。该服务器在stdio上运行,并提供用于查询Magic:The Gathering卡数据的工具,这些工具具有智能自然语言处理功能。
自然语言映射类别
- 文本和能力:进入/离开战场、牺牲、摧毁、飞行等。
- 颜色:所有颜色名称、公会名称、颜色组合
- 类型:生物、法术、人工制品、特定生物类型
- 格式:标准、现代、传统、指挥官、先锋等。
- 成本:便宜、昂贵、特定法力消耗、预算范围
许可证
麻省理工学院