MTG MCP Server

mtg-mcp-server

AI アシスタントに Magic: The Gathering のカードデータ、コンボ、ドラフト分析、統率者戦のメタゲーム、競技構築、サイドボード戦略、デッキ構築、ルールエンジンなどへの深いアクセスを提供する、69 個のツール、19 個のプロンプト、21 個のリソースを備えています。Claude Code、Claude Desktop、またはあらゆる MCP クライアントで利用できます。

Scryfall、Commander Spellbook、17Lands、EDHREC、Moxfield、Spicerack、MTGGoldfish のデータを基に構築されています。詳細と利用条件については、データソースとクレジット表記をご覧ください。

目次

• できること — プロンプト例と実際のツール出力
• インストール — ホスト型、Claude Code、Claude Desktop、PyPI、開発環境
• 設定 — 環境変数と機能フラグ
• ツール — 13 の領域にわたる全 69 個のツール
• アーキテクチャ — FastMCP 3.x のマウントシステム
• 技術スタック — Python 3.12+、FastMCP、httpx、Pydantic
• 開発 — テスト、リンティング、型チェック用の mise コマンド
• ドキュメント — クックブック、アーキテクチャ、ツールリファレンスなど
• ステータス — 現在のツール数とテスト数
• データソースとクレジット表記 — Scryfall、Spellbook、17Lands、EDHREC、Moxfield、Spicerack、MTGGoldfish

できること

次のような質問を AI アシスタントにすると、MTG ツールが自動的に使われます。

統率者戦

• 「統率者としての Muldrotha について、すべて教えて」
• 「5 ドル以内でできる、Atraxa デッキのおすすめ予算アップグレードは？」
• 「墓地をテーマにした統率者として、Muldrotha、Meren、Karador を比較して」

ドラフトとリミテッド

• 「Foundations のドラフトでおすすめのコモンは？」
• 「ドラフトパックのカードを評価して。Bitter Triumph、Monstrous Rage、Torch the Tower」
• 「このプールからシールドデッキを構築して：[リスト]」

デッキ構築

• 「自分のモダンのデッキリストを検証して」
• 「3 色の統率者戦デッキ向けにマナベースを提案して」
• 「ゴルガリの生け贄テーマと相性のよいカードを探して」

ルール

• 「接死とトランプルはどのように相互作用しますか？」
• 「この戦闘状況を解決して。先制攻撃を持つ自分の 3/3 で、トランプルを持つ相手の 5/5 をブロックします」

構築戦

• 「現在のモダンのメタゲームはどのような状況ですか？」
• 「モダンで定番のボロス・エネルギーのデッキリストを見せて」
• 「このパイオニアのデッキ用のサイドボードを構築して」
• 「アゾリウス・コントロール相手に使う、自分のデッキのサイドボードガイドを教えて」

実際の動作を見る

「墓地を活用する統率者として、Muldrotha、Meren、Karadorを比較してください」

                     Muldrotha            Meren               Karador
Mana Cost            {3}{B}{G}{U}         {2}{B}{G}           {5}{W}{B}{G}
Color Identity       BGU (Sultai)         BG (Golgari)        BGW (Abzan)
Stats                6/6                  3/4                  3/4
EDHREC Rank          #1,137               #1,476              #9,894
Total Decks          22,460               19,919              6,305
Combo Count          10                   1                   10

Top Staples:
  Muldrotha           Spore Frog (+53%), Sakura-Tribe Elder (+36%), Eternal Witness (+27%)
  Meren               Spore Frog (+70%), Sakura-Tribe Elder (+55%), Viscera Seer (+52%)
  Karador             Karmic Guide (+51%), Satyr Wayfinder (+49%), Sun Titan (+48%)

「ドラフトで使えるFoundationsのコモンのおすすめは何ですか？」

Foundations (FDN) — PremierDraft · Median GIH WR: 54.7%

Rank  Card               Color  GIH WR   ALSA   IWD      Games
1     Bake into a Pie    B      58.4%    3.1    +5.3%    354,741
2     Burst Lightning    R      58.2%    3.3    +3.0%    338,888
3     Refute             U      58.1%    5.3    +4.3%    321,280
4     Stab               B      57.9%    3.4    +4.5%    376,569
5     Dazzling Angel     W      57.8%    3.2    +2.4%    317,648

Trap rares: Doubling Season (39.4%), Thousand-Year Storm (35.2%) ...

実際のツール出力を含むその他の例は、Cookbookをご覧ください。

インストール

APIキーは不要です。すべてのデータソースは公開されています。

ホスティング版（セットアップ不要）

すぐに使い始めるための最速の方法です。Pythonのインストールは不要で、モバイルでも動作します。

UIから（Claude Desktopまたはclaude.ai）：Settings → Connectors → Add custom connector → URLを貼り付けます：

https://mtg-mcp-server.fastmcp.app/mcp

設定ファイルから（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "mtg": {
      "type": "url",
      "url": "https://mtg-mcp-server.fastmcp.app/mcp"
    }
  }
}

Claude Code

claude mcp add mtg -- uvx mtg-mcp-server

またはUIから：Settings → MCP Servers → Add server → コマンドとしてuvx mtg-mcp-serverを入力します。

Claude Desktop（ローカル）

お使いのマシン上で実行します。Python 3.12以降が必要です。

{
  "mcpServers": {
    "mtg": {
      "command": "uvx",
      "args": ["mtg-mcp-server"]
    }
  }
}

PyPI

# Run directly (no install)
uvx mtg-mcp-server

# Install globally
uv tool install mtg-mcp-server

# Add to a project
uv add mtg-mcp-server

開発

git clone https://github.com/j4th/mtg-mcp-server.git
cd mtg-mcp-server
mise install          # Installs Python 3.12, uv, ruff, ty
mise run setup        # Creates venv, installs dependencies

uv run mtg-mcp-server # Run the server

ローカル開発用のClaude Code設定：

{
  "mcpServers": {
    "mtg": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mtg-mcp-server", "mtg-mcp-server"]
    }
  }
}

設定

すべての設定にはMTG_MCP_環境変数を使用します。適切なデフォルト値が設定されているため、すぐに利用できます。

# Feature flags for optional backends
MTG_MCP_ENABLE_EDHREC=false       # EDHREC (scrapes undocumented endpoints)
MTG_MCP_ENABLE_17LANDS=false      # 17Lands (rate-limits aggressively)
MTG_MCP_ENABLE_BULK_DATA=false    # Scryfall bulk data (~30MB download on first use)
MTG_MCP_ENABLE_RULES=false        # Comprehensive Rules engine

# Pass env vars through uvx
uvx --env MTG_MCP_ENABLE_EDHREC=false mtg-mcp-server

ベースURL、レート制限、キャッシュ設定など、利用可能なすべてのオプションについては.env.exampleをご覧ください。

ツール

13の領域にわたる69個のツールがあります。入力と出力の詳細については、docs/TOOL_DESIGN.mdをご覧ください。

カードデータ（scryfall_*）

ツール	説明
search_cards	Scryfallの構文を使って検索します（f:commander id:sultai t:creature）
card_details	正確な名前またはあいまい検索によるカードの全データ
card_price	現在のUSD、EUR、およびフォイル価格
card_rulings	公式裁定と解説
set_info	コードによるセットのメタデータ
whats_new	最近発売またはプレビューされたカード

一括データ（bulk_*）

ツール	説明
card_lookup	レート制限なしで、正確な名前からカードを検索します
card_search	名前、タイプ、またはOracleテキストで検索します
format_legality	カードがフォーマットで使用可能か確認します
format_search	特定のフォーマットで使用可能なカードを検索します
format_staples	EDHRECランクに基づく、フォーマットで最もよく使われるカード
ban_list	フォーマットの禁止・制限カード
card_in_formats	すべてのフォーマットにおけるカードの使用可否
random_card	フォーマットまたはタイプで絞り込み可能なランダムカード
similar_cards	タイプ、キーワード、またはマナ・コストが似たカードを検索します

コンボ（spellbook_*）

ツール	説明
find_combos	カード名と色の固有性でコンボを検索します
combo_details	IDで指定したコンボの手順ごとの説明
find_decklist_combos	デッキリストに含まれるコンボを検索します
estimate_bracket	デッキリストのCommanderブラケットを推定します

ドラフト分析（draft_*）

ツール	説明
card_ratings	セット内のカードの勝率とドラフトデータ（17Lands）
archetype_stats	セットの色の組み合わせごとの勝率

統率者メタゲーム（edhrec_*）

ツール	説明
commander_staples	シナジースコア付きの、統率者で最もよく使われるカード
card_synergy	特定の統率者とのカードのシナジーデータ

デッキリスト（moxfield_*）

ツール	説明
decklist	デッキIDまたはURLからデッキリスト全体を取得します
deck_info	デッキのメタデータ（名前、フォーマット、作成者、日付）
search_decks	フォーマット、キーワード、または並べ替え順で公開デッキを検索します
user_decks	ユーザーの公開デッキ一覧

トーナメントデータ（spicerack_*）

ツール	説明
recent_tournaments	競技フォーマットの最近のトーナメント
tournament_results	特定のトーナメントの全順位
format_decklists	最近のトーナメントで上位入賞したデッキリスト

メタゲーム（goldfish_*）

ツール	説明
metagame	競技フォーマットの現在のメタゲームの概要
archetype_list	アーキタイプのサンプルデッキリスト
format_staples	フォーマットで最もよく使われるカードと、デッキへの採用率
deck_price	アーキタイプデッキの紙のカードでの推定価格

統率者戦のワークフロー

ツール	説明
commander_overview	すべてのソースに基づく統率者の詳細プロフィール
evaluate_upgrade	カードをデッキに追加する価値があるかを評価
card_comparison	統率者デッキ向けに2～5枚のカードを横並びで比較
budget_upgrade	予算の制約に合わせて、シナジーと価格の比率で順位付けしたアップグレード案
commander_comparison	2～5人の統率者を直接比較
color_identity_staples	同じ固有色のすべての統率者デッキでよく使われるカード

デッキ構築

ツール	説明
theme_search	メカニズムまたは部族のテーマに合うカードを検索
build_around	キーカードとのシナジーを検出し、補完カードを検索
complete_deck	部分的なデッキリストの不足を分析し、提案
tribal_staples	特定の固有色において、クリーチャー・タイプに適した最良のカード
precon_upgrade	構築済みデッキを分析し、入れ替え候補のペアを提案
suggest_cuts	デッキリストから抜くべき最も弱いカードを特定
deck_analysis	デッキリスト全体の健全性をチェック（マナカーブ、色、コンボ、予算）
deck_validate	フォーマットの構築ルールに照らしてデッキリストを検証
suggest_mana_base	色マナ・シンボルの分布に基づいて土地を提案
price_comparison	複数のカードの価格を比較

ドラフトのワークフロー

ツール	説明
draft_pack_pick	17Landsのデータを使ってドラフトパック内のカードを順位付け
set_overview	フォーマットで評価の高いコモン／アンコモンと、注意すべきレアを紹介
sealed_pool_build	シールドプールから最適な40枚のデッキを提案
draft_signal_read	ドラフトのピックから空いている色を検出
draft_log_review	完了したドラフトをピックごとに評価し、成績を提示

構築戦のワークフロー

ツール	説明
rotation_check	スタンダードのローテーション状況と、ローテーションで使用できなくなるカード
metagame_snapshot	価格付きの、ティア別メタゲーム概要
archetype_decklist	競技アーキタイプの標準的なデッキリスト
archetype_comparison	2～4種類のアーキタイプを横並びで比較
format_entry_guide	競技フォーマットへの参加方法を説明する初心者向けガイド
suggest_sideboard	デッキ向けの15枚のサイドボード案
sideboard_guide	特定のマッチアップでのサイドボードの入れ替え案
sideboard_matrix	よくあるマッチアップを網羅したサイドボードの一覧表

ルールエンジン

ツール	説明
rules_lookup	番号またはキーワードでルールを検索
keyword_explain	キーワードのルールとカード例を解説
rules_interaction	2つのメカニズムがどのように相互作用するかをルールの引用付きで説明
rules_scenario	ゲームの状況に適用されるルールの枠組み
combat_calculator	キーワード能力の相互作用を含めた、戦闘フェイズのステップごとの解説

アーキテクチャ

FastMCP 3.x を基盤としています。各データソースは独立したサブサーバーとして、単一のオーケストレーターにマウントされます。

MTG (orchestrator)
├── scryfall (namespace: scryfall_)     -> Scryfall REST API
├── spellbook (namespace: spellbook_)   -> Commander Spellbook API
├── draft (namespace: draft_)           -> 17Lands data
├── edhrec (namespace: edhrec_)         -> EDHREC (scraped, feature-flagged)
├── bulk (namespace: bulk_)             -> Scryfall Oracle Cards bulk data
├── moxfield (namespace: moxfield_)     -> Moxfield (reverse-engineered, feature-flagged)
├── spicerack (namespace: spicerack_)   -> Spicerack tournament API
├── goldfish (namespace: goldfish_)     -> MTGGoldfish (scraped, feature-flagged)
└── workflows (no namespace)            -> 36 tools (31 composed + 5 rules)

サービスは純粋な非同期 API クライアントです。プロバイダーが MCP ツールを登録します。ワークフローはサービスを横断して連携し、一部の処理に失敗しても許容します。全体像についてはdocs/ARCHITECTURE.mdを参照してください。

技術スタック

ランタイム	Python 3.12+、uv
MCP	FastMCP 3.2.x
HTTP	httpx（非同期）
バリデーション	Pydantic v2
ロギング	structlog
開発ツール	mise、ruff、ty（Astral）
テスト	pytest、respx、pytest-asyncio
HTML パース	selectolax

開発

git clone https://github.com/j4th/mtg-mcp-server.git
cd mtg-mcp-server
mise install          # Installs Python, uv, ruff, ty
mise run setup        # Creates venv, installs dependencies

mise run check        # Full quality gate: lint + typecheck + tests
mise run check:quick  # Fast gate: lint + typecheck + affected tests only
mise run test         # All tests with coverage
mise run test:quick   # Only tests affected by recent changes
mise run lint         # ruff check + format check
mise run typecheck    # ty check
mise run dev          # MCP Inspector for interactive testing
mise run fix          # Auto-fix lint and format issues

ドキュメント

ドキュメント	内容
COOKBOOK.md	使用レシピ -- 統率者、ドラフト、デッキ構築、ルールのワークフロー
TOOL_DESIGN.md	69 個のツール、19 個のプロンプト、21 個のリソースの完全なリファレンス
ARCHITECTURE.md	技術アーキテクチャ、FastMCP のパターン、設計上の決定事項
SERVICE_CONTRACTS.md	API エンドポイント、レート制限、バックエンドごとのレスポンス形式
DATA_SOURCES.md	認証、安定性、アクセスパターンを含むすべてのデータソース
CACHING_DESIGN.md	TTL キャッシュ戦略と Scryfall バルクデータの設計
CONTRIBUTING.md	開発環境のセットアップ、TDD ワークフロー、コードスタイル、PR の手順
CHANGELOG.md	Keep a Changelog 形式のバージョン履歴

ステータス

69 個のツール、19 個のプロンプト、21 個のリソーステンプレート。1340 件のテスト、カバレッジ 88%。

フェーズ	内容	ステータス
0	プロジェクトのひな形	完了
1	Scryfall バックエンド（4 個のツール）	完了
2	Spellbook、17Lands、EDHREC バックエンド（9 個のツール）	完了
3	ワークフローツール -- 統率者、ドラフト、デッキ（4 個のツール）	完了
4	TTL キャッシュ + Scryfall バルクデータプロバイダー（2 個のツール）	完了
5	分析・比較ワークフロー、プロンプト、リソース（4 個のツール）	完了
ブランチ A	構造化出力、ルールエンジン、検証ツール（17 個のツール）	完了
ブランチ B	フォーマット別ワークフロー -- デッキ構築、統率者の詳細分析、リミテッド、構築戦（11 個のツール）	完了
Moxfield	Moxfield デッキリストプロバイダー（4 個のツール）	完了
Spicerack	トーナメント結果プロバイダー（3 個のツール）	完了
MTGGoldfish	メタゲームデータプロバイダー（4 個のツール）	完了
v2.3.0	メタゲームワークフロー、サイドボードツール、Moxfield 検索（9 個のツール）	完了

データソースとクレジット表記

このプロジェクトは、複数のサードパーティサービスのデータを組み合わせています。

• Scryfall -- カードデータベース、価格、裁定、検索、バルクデータ（API ガイドライン）
• Commander Spellbook -- コンボ検索、ブラケット推定（MIT ライセンス）
• 17Lands -- ドラフトのカード評価、アーキタイプの勝率（利用ガイドライン）
• EDHREC -- 統率者戦の定番カード、シナジースコア（未公開のエンドポイント、機能フラグで無効化）
• Moxfield -- 公開デッキリストとデッキ検索（リバースエンジニアリングした API、機能フラグで無効化）
• Spicerack -- トーナメント結果と順位（ドキュメント化された API）
• MTGGoldfish -- 競技メタゲームデータ、アーキタイプ、フォーマットの定番カード（HTML スクレイピング、機能フラグで無効化）

ライセンス全文と利用規約については、THIRD_PARTY_NOTICES.md を参照してください。

免責事項

mtg-mcp-server は、ファンコンテンツポリシーで許可されている非公式のファンコンテンツです。Wizards の承認または公認を受けたものではありません。使用している資料の一部は Wizards of the Coast の所有物です。© Wizards of the Coast LLC.

ライセンス

MIT -- LICENSE を参照