mtg-oracle

mtg-oracle

Magic: The Gathering の MCP サーバーです。カード検索、ルール検索、デッキ分析、統率者戦の情報を提供します。

Model Context Protocol を通じて、AI アシスタントが Magic のカード、ゲームルール、コンボ、シナジー、フォーマットのメタゲームに関する質問に答えるための 14 個のツールを提供します。

単なる Scryfall ラッパーではありません。 mtg-oracle はカードデータ、総合ルール、コンボデータベースを SQLite にダウンロードしてローカルに保存するため、高速なオフライン検索が可能です。また、厳選された MTG の知識（アーキタイプ、フォーマットの入門情報、統率者戦の戦略、マナベースのガイドライン）も付属しており、LLM が 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	名前、タイプ、色、マナ・コスト、レアリティ、セット、フォーマット、キーワードでカードを検索します。名前、タイプ行、オラクルテキストを全文検索できます。
get_card	特定のカードの詳細情報（オラクルテキスト、マナ・コスト、タイプ、P/T、裁定、使用可能フォーマット）を取得します。あいまいな名前にも対応しています。
get_rulings	カードに関する Wizards of the Coast の公式裁定（相互作用、例外的な状況、明確化）を取得します。
check_legality	1 枚以上のカード（最大 50 枚）のフォーマット使用可否を確認します。統率者戦、モダン、スタンダード、レガシー、ヴィンテージなどに対応しています。
search_by_mechanic	特定のキーワードやメカニズム（飛行、トランプル、続唱など）を持つカードを検索します。キーワードのルール上の定義も任意で含められます。
get_prices	1 枚以上のカード（最大 50 枚）の現在の市場価格を検索します。Scryfall の USD、USD フォイル、EUR、MTGO チケット価格を返します。

デッキツール

ツール	説明
analyze_deck	デッキリスト（プレーンテキストまたは MTGO XML）を分析します。マナカーブ、色の分布、カードタイプの内訳、マナベース分析、フォーマット使用可否の確認結果を返します。

ルールツール

ツール	説明
lookup_rule	セクション番号（例：「702.1」）を指定するか、テキストで検索して総合ルールを参照します。サブセクションと上位ルールの文脈を含むルール本文を返します。
get_glossary	公式用語集でゲーム用語（「パーマネント」「呪文」「スタック」「優先権」など）を検索します。
get_keyword	キーワード能力（飛行、接死、装備など）の公式ルール定義を取得します。

Commander ツール

ツール	説明
analyze_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