Mtg Oracle

io.github.gregario由 GitHub 账号 gregario 发布v0.1.0更新于 Oct 27, 2026

Magic: The Gathering MCP server — cards, rules, combos, and Commander intelligence

已验证STDIO仅桌面知识与记忆数据与分析

概览

AI 生成的概览

本地运行的万智牌 MCP 服务器，让助手搜索卡牌、查询规则、分析套牌，并探索指挥官组合技与协同。

可以做什么
  • 搜索与查看卡牌：全文卡牌搜索、卡牌完整信息、官方裁定、赛制合法性检查、按机制检索以及市场价格
  • 分析套牌：根据纯文本或 MTGO XML 牌表给出法力曲线、颜色与类别分布、法术力基础分析和合法性检查
  • 查询规则：按章节编号或文本查找完整规则、官方术语表和关键字异能定义
  • 指挥官支持：指挥官策略分析、来自 Commander Spellbook 的已知无限组合技、协同类别以及各赛制常用牌
适用场景
适合希望助手准确回答万智牌问题的场景，例如查卡、规则争议、组牌与调牌、指挥官策略，或查询组合技与赛制合法性，无需手动粘贴卡牌文本。
运行要求
以 Node.js 本地进程运行，可通过 npm 全局安装或用 npx 直接启动。首次运行会从 Scryfall 下载卡牌数据、从 Academy Ruins 下载规则数据到本地目录，之后自动更新，因此需要网络访问。未声明任何账号、API 密钥或环境变量。
安装前请注意
首次运行会向本地存储下载较大的卡牌与规则数据集，并在后续运行中自动刷新。卡牌、组合技和规则数据来自第三方来源（Scryfall、Commander Spellbook、Academy Ruins），价格仅供参考。属于非官方同人内容，未获威世智认可。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mtg Oracle，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mtg-oracle

[npm version] [npm downloads] [License: MIT] [Node.js] [MCP] [gregario/mtg-oracle MCP server]

Magic: The Gathering MCP server. Card search, rules lookup, deck analysis, and Commander intelligence.

Provides 14 tools for AI assistants to answer questions about Magic cards, game rules, combos, synergies, and format meta via the Model Context Protocol.

Not just another Scryfall wrapper. mtg-oracle downloads card data, comprehensive rules, and combo databases locally into SQLite for fast offline queries, and ships with curated MTG knowledge (archetypes, format primers, commander strategies, mana base guidelines) that makes LLMs genuinely competent at Magic.

Installation

bash
npm install -g mtg-oracle

Or run directly with npx:

bash
npx mtg-oracle

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Or if installed globally:

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

Claude Code Configuration

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

Data

On first run, mtg-oracle downloads card data from Scryfall and rules data from Academy Ruins. Data is stored in ~/.mtg-oracle/ and updated automatically on subsequent runs. No card data is bundled in the npm package.

Tools

Card Tools

ToolDescription
search_cardsSearch cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text.
get_cardGet complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching.
get_rulingsGet official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications).
check_legalityCheck format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more.
search_by_mechanicFind cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition.
get_pricesLook up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall.

Deck Tools

ToolDescription
analyze_deckAnalyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.

Rules Tools

ToolDescription
lookup_ruleLook up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context.
get_glossaryLook up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.).
get_keywordGet the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.).

Commander Tools

ToolDescription
analyze_commanderAnalyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding.
find_combosFind known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results.
find_synergiesFind synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card.
get_format_staplesGet staple cards and popular archetypes for any format. Optionally filter by archetype.

Development

bash
# Install dependenciesnpm install
# Run testsnpm test
# Buildnpm run build
# Run locallynpm start

Attribution

Legal

This is unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards of the Coast. Portions of the materials used are property of Wizards of the Coast. All rights reserved.

License

MIT

来源：README.md，提交 e8d736d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分