Vizier Yu-Gi-Oh! MCP

Yu-Gi-Oh! カードデータのためのModel Context Protocolサーバー：カード、価格、収録、禁止・制限カードリスト（履歴＋複数フォーマット）、公式裁定、包括ルール、カード関連、デッキツール。すべて単一のSQLiteデータベースと組み込みベクトル検索でローカルに動作し、クエリ時にネットワーク呼び出しはありません。

特徴

• カード：正確なIDまたはあいまい一致の名前での検索、タイプ/ATKフィルター付きキーワード検索、効果説明による意味的（ベクトル）検索、アーキタイプ一覧。

• 価格と収録：現在の市場価格（cardmarket / tcgplayer / ebay / amazon）、レアリティと価格を含む完全な収録履歴。

• 禁止・制限カードリスト：tcg、ocg、ocg-ae、ocg-cn、master-duel、rush、genesys、ocg-genesys、goat、edison のスナップショット。全フォーマットでのカードごとのステータス、スナップショット間の履歴差分。

• ルールと裁定：公式包括ルールブック（380セクション）と2,650件以上の公式OCG裁定に対する意味的検索。カードごとの裁定検索（ライブフェッチフォールバック付き）。

• 関連：カードテキストから抽出された検索/召喚/破壊/対象関連、融合・シンクロ・エクシーズ・リンク・儀式素材要件、逆引き、アーキタイプサポート検出。

• デッキ：デッキリストをフォーマットの禁止・制限カードリストに対して検証、メイン/エクストラ構成とアーキタイプ構成を分析。

Related MCP server: Scryfall MCP Server

要件

• Python 3.11以上

• 埋め込みモデルのダウンロードに約1 GBのディスク容量。ビルド済みデータベースは約75 MB

• ビルド中に約2 GBのRAM（埋め込みモデル）。クエリ時ははるかに少ない

データベースパスとデータディレクトリは、VIZIER_DB_PATH と VIZIER_DATA_DIR 環境変数で上書きできます（デフォルトは <package root>/data/）。

セットアップ

python -m venv .venv
source .venv/bin/activate
pip install -e .

データベースのビルド

ビルドは、キャッシュされたAPIデータ（data/cache/）と参照プロジェクト（ref/、policy/）を data/vizier.db に取り込みます。--fetch を渡さない限りネットワークは不要です。

# full build including embeddings (slow: ~15-20 min CPU for 17.6k vectors)
python scripts/build_db.py

# faster variants
python scripts/build_db.py --no-embed      # skip vector embeddings (no semantic search)
python scripts/build_db.py --skip-cards    # skip card ingestion, re-embed only
python scripts/build_db.py --fetch         # download fresh API payloads first

--fetch はYGOPRODeckからカードダンプをダウンロードします。注意：現在のライブAPIはHTTP 403を返すため、data/cache/ のキャッシュダンプが正とされます。APIに到達できない場合、ビルドはキャッシュを使用します。

サーバーの実行

python -m vizier_mcp

サーバーはstdio上でMCPを話します。コンソールスクリプトもあります：

vizier-mcp

クライアント設定

任意のMCPクライアントをインストール済みコマンドにポイントします。サーバー名は vizier-yugioh です。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "vizier-yugioh": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "vizier_mcp"]
    }
  }
}

汎用クライアント

{
  "mcpServers": {
    "vizier-yugioh": {
      "command": "/path/to/.venv/bin/vizier-mcp",
      "args": []
    }
  }
}

venvへの絶対パスを使用してください。DBパスはパッケージの場所（または VIZIER_DB_PATH）を基準に解決され、CWDではありません。

ツール

filter_type の例：monster、spell、trap、effect、fusion、link、pendulum、tuner、normal monster、normal spell、quick-play、counter trap、equip、field、ritual。複数単語のフィルターは正確なサブタイプに一致します。

コンボ作成

サーバーには組み込みのコンボ作成プレイブックが付属しており、ライン構築を決定論的な幅優先プロセスに変換します：すべての可能なアクションを列挙し、展開し、深め、剪定し、記録し、繰り返します。

1. combo_guide() — プレイブックを読み込みます（combo プロンプトとしても利用可能）。コンボ状態のJSONスキーマ、6ステッププロトコル、カードごとの列挙チェックリスト、ツールルーティング、ハード/ソフト1ターンに1度の規律、ロック検出、終了条件を定義します。

2. card_combo_profile() — 検討中の任意のカードについて：召喚オプション（通常/生け贄/ペンデュラム/自己特殊召喚）、アクティベーション種類＋1ターンに1度のステータス＋アクション動詞を持つすべての効果、ロック/制限文、完全な関連グラフ（検索/召喚/破壊/対象/素材）、必要な素材、および素材として使用できるモンスター（名前指定＋アーキタイプ全体）。

3. board_options() — 1回の呼び出しで、現在のボードからのすべての合法的な次の手を返します（アーキタイプ非依存）：すべてのエクストラデッキ召喚（デッキのアーキタイプだけでなく、約2,300モンスターの全プール）、すべての手札モンスターのプレイ（通常召喚/自己特殊召喚/ペンデュラムスケール）、ターゲット付きのすべての検索/追加効果（アーキタイプターゲットは上位メンバーをリスト）、ペンデュラム召喚範囲、アクティブ/保留中のロック。これはトンネルビジョン防止ツールです：モデルはアーキタイプ内の候補に自分を制限してはなりません。

4. line_search() — サーバー側の制限付き幅優先探索で、現在のボードから目標（field_levels、field_count、no_locks、reach_field、reach_hand）まで。完全なマルチステップラインを返すため、モデルは1手ずつではなく数手先を計画します。

5. extra_deck_options() — 現在のフィールド（手札/墓地/エクストラデッキとフォーマットも）を貼り付けると、素材要件が満たされるすべての融合/シンクロ/エクシーズ/リンク/儀式モンスターを、各候補の正確な素材推論とともに取得します。

例 — フィールドにレベル4の D/D モンスターが2体：

extra_deck_options(field=["D/D Savant Copernicus", "D/D Ark"], summon_types="xyz")
→ options include D/D/D Wise King Solomon ("2 Level 4 D/D monsters")

ベストエフォート素材チェックは完全な関連グラフに対して検証されます。ラインを確定する前に、境界の候補は常に get_card_materials で確認してください。

リソース

スペースを含むリソースパラメータはURLエンコードしてください（rules://damage%20step）。

データベース構成

data/vizier.db — sqlite-vec 拡張機能を備えたSQLite。主要テーブル:

• cards — カードごとに1行、計算されたタイプフラグ付き（is_monster、is_quickplay_spell、...）

• card_sets, card_prices — 収録情報と市場価格

• card_ban_status, banlist_history — フォーマットごとの現在のステータス＋過去のスナップショット

• relations — カード間の効果の関連性（タイプ付き）

• rulebook_chunks, rulings — ルールと裁定のテキスト

• card_vec, rule_vec, ruling_vec — セマンティック検索用の埋め込みテーブル

• meta — ビルドのタイムスタンプと件数

データソース

• カード / 価格 / 禁止カードリスト: YGOPRODeck バルクAPI（data/cache/ にキャッシュ）

• ルール: 公式総合ルールブック（ref/yugioh_comprehensive_rulebook/）

• 裁定: 公式OCG裁定Q&Aリスト＋YGOPEDIAフォールバック

• ポリシー: 大会ポリシー文書（policy/）

テスト

python -m pytest tests/ -q

プロセス内サーバークライアントに対して32件のスモークテストを実行し、すべてのツールとリソースをカバーします。