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 分