mtg-oracle

mtg-oracle

Magic: The Gathering MCP 服务。提供卡牌搜索、规则查询、套牌分析和指挥官策略分析。

通过 Model Context Protocol 提供 14 种工具，让 AI 助手能够回答有关 Magic 卡牌、游戏规则、组合技、协同效应和赛制环境的问题。

不只是又一个 Scryfall 封装工具。 mtg-oracle 会将卡牌数据、综合规则和组合技数据库下载到本地 SQLite，以便快速离线查询；还内置精选的 MTG 知识（原型、赛制指南、指挥官策略、法术力基础指南），让大模型真正具备 Magic 知识。

安装

npm install -g mtg-oracle

也可以通过 npx 直接运行：

npx mtg-oracle

Claude Desktop 配置

添加到 Claude Desktop 配置文件（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "mtg-oracle": {
      "command": "npx",
      "args": ["-y", "mtg-oracle"]
    }
  }
}

也可以在全局安装后使用：

{
  "mcpServers": {
    "mtg-oracle": {
      "command": "mtg-oracle"
    }
  }
}

Claude Code 配置

claude mcp add mtg-oracle -- npx -y mtg-oracle

数据

首次运行时，mtg-oracle 会从 Scryfall 下载卡牌数据，并从 Academy Ruins 下载规则数据。数据存储在 ~/.mtg-oracle/ 中，后续运行时会自动更新。npm 软件包中不包含卡牌数据。

工具

卡牌工具

工具	描述
search_cards	按名称、类别、颜色、法术力费用、稀有度、系列、赛制或关键字搜索卡牌。支持跨名称、类别行和 Oracle 文本的全文搜索。
get_card	获取特定卡牌的完整详情：Oracle 文本、法术力费用、类别、力量/防御力、裁定和合法性。支持模糊名称匹配。
get_rulings	获取威世智针对某张卡牌发布的官方裁定（互动、边缘情况、说明）。
check_legality	检查一张或多张卡牌（最多 50 张）在赛制中的合法性。支持指挥官、摩登、标准、薪传、特选等赛制。
search_by_mechanic	查找具有特定关键字或机制（飞行、践踏、级联等）的卡牌。可选择同时提供该关键字的规则定义。
get_prices	查询一张或多张卡牌（最多 50 张）的当前市场价格。返回 Scryfall 提供的美元、闪卡美元、欧元和 MTGO 票券价格。

套牌工具

工具	描述
analyze_deck	分析套牌列表（纯文本或 MTGO XML）。返回法术力曲线、颜色分布、类别细分、法术力基础分析和赛制合法性检查。

规则工具

工具	描述
lookup_rule	按章节编号（例如“702.1”）查找综合规则，或按文本搜索。返回包含子章节和上级上下文的规则文本。
get_glossary	查询官方术语表中的游戏术语（如“永久物”“咒语”“堆叠”“优先权”等）。
get_keyword	获取关键字异能（飞行、死触、佩带等）的官方规则定义。

Commander 工具

工具	描述
analyze_commander	将传奇生物作为 Commander 进行分析：策略、原型，以及构筑套牌时推荐的卡牌类别。
find_combos	从 Commander Spellbook 中查找已知的无限连招。按卡牌名称或颜色标识搜索。返回步骤、前提条件和结果。
find_synergies	查找协同类别（衍生物、牺牲、指示物等）以及与特定卡牌配合良好的示例卡牌。
get_format_staples	获取任意赛制的必备卡牌和热门原型。可选择按原型筛选。

开发

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run locally
npm start

鸣谢

• 卡牌数据由 Scryfall 提供。本项目并非由 Scryfall 制作，也未获其认可。
• 连招数据来自 Commander Spellbook。
• 规则数据来自 Academy Ruins。

法律声明

这是根据 粉丝内容政策 获准发布的非官方粉丝内容。未经 Wizards of the Coast 批准或认可。所用材料的部分内容为 Wizards of the Coast 的财产。保留所有权利。

许可证

MIT