Каталог MCP
gregario/mtg-oracle

gregario/mtg-oracle

Name: gregario/mtg-oracle
Availability: InStock
Author: gregario

MCP сервер для Magic: The Gathering с 14 инструментами: поиск карт, правил, анализ колод, комбо и синергии. Работает офлайн на SQLite - отличный помощник для AI ассистентов, глубоко понимающих MTG.

Github NPM Сайт сервера

README

14 инструментов

Версии

Установить сервер

mtg-oracle

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

npm install -g mtg-oracle

Or run directly with npx:

npx mtg-oracle

Claude Desktop Configuration

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

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

Or if installed globally:

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

Инструменты были проиндексированы: 15.10.2026

analyze_commander

Анализирует легендарное существо в качестве потенциального Commander. Возвращает цветовую идентичность, предлагаемые стратегии, архетипы и рекомендуемые категории карт для сборки колоды вокруг этого Commander. Используйте это, когда пользователь просит помочь собрать или оценить колоду для Commander.

Параметры

namestringобязательный
Название карты командира для анализа.

analyze_deck

Анализирует список колоды Magic: The Gathering. Вставьте список колоды (в виде простого текста, например '4 Lightning Bolt' на строку, или XML-файла .dek MTGO) и получите кривую маны, распределение цветов, разбивку по типам, анализ мана-базы и проверку соответствия формату. Используйте этот инструмент, когда пользователь делится списком колоды и хочет получить обратную связь.

Параметры

deck_liststringобязательный
Список колоды в виде простого текста или в формате XML .dek MTGO.
formatstring
Формат для проверки легальности (например, "modern", "commander", "standard")

check_legality

Проверяет, в каких форматах легальна карта (или несколько карт). Используйте это, когда пользователь хочет узнать, легальна ли карта, запрещена или ограничена в форматах, таких как Commander, Modern, Standard, Legacy или Vintage. Принимает одно название карты или массив до 50 названий карт.

Параметры

cardsstring | string[]обязательный
Имя карты или массив имён карт (максимум 50).
formatstring
Конкретный формат для проверки (например, "commander", "modern"). Опустите для всех форматов.

find_combos

Находит известные бесконечные комбинации и синергетические комбинации карт из Commander Spellbook. Используй это, когда пользователь спрашивает о комбинациях с определёнными картами, комбинациях в определённых цветах или хочет найти условия победы. Возвращает шаги комбинации, предварительные условия и результаты.

Параметры

card_namestring
Название одной карты для поиска комбо.
card_namesstring[]
Несколько названий карт для поиска комбо.
color_identitystring[]
Фильтрует комбо в рамках этой цветовой идентичности (например, ["W","U","B"])
limitnumber
Максимум результатов (по умолчанию: 5, максимум: 20)

find_synergies

Находит категории синергии и примеры карт, которые хорошо сочетаются с конкретной картой. Используйте это, когда пользователь хочет узнать, какие стратегии или типы карт дают синергию с конкретной картой. Определяет подходящие архетипы (жетоны, жертвоприношение, счетчики и т.п.) и предлагает дополняющие карты.

Параметры

card_namestringобязательный
Название карты для поиска синергий
categorystring
Фильтрует по ID конкретной категории синергии.
color_identitystring[]
Отфильтровывает синергетические карты в рамках этой цветовой идентичности.
formatstring
Фильтрует по релевантности формата.
limitnumber
Максимум образцов карточек на категорию (по умолчанию 5, максимум 50)

get_card

Получает полную информацию по конкретной карте Magic: текст Oracle, мана-стоимость, тип, сила/выносливость, разъяснения и легальность в форматах. Используй, когда знаешь точное название карты (или близкое) и нужны все данные. Поддерживает нечёткое соответствие - частичные названия работают.

Параметры

namestringобязательный
Название карты для поиска.

get_format_staples

Получает основные карты и популярные архетипы для конкретного формата (Commander, Modern, Legacy и т.д.). Используйте это, когда пользователь спрашивает о мете, популярных колодах или ключевых картах в формате. Можно отфильтровать по архетипу.

Параметры

archetypestring
Необязательный фильтр архетипа (например, "aggro-red", "control-uw")
formatstringобязательный
Формат для получения staples (например, "commander", "modern", "legacy")

get_glossary

Ищет термин в глоссарии Magic: The Gathering. Используй этот инструмент, когда пользователь спрашивает «что означает X» для специфической игровой терминологии, такой как «permanent», «spell», «stack», «priority» и т.д. Поддерживает частичное совпадение.

Параметры

termstringобязательный
Термин из глоссария для поиска (без учёта регистра). Поддерживает точное и частичное совпадение.

get_keyword

Получает официальное определение правил для ключевого слова Magic (например, «Полет», «Смертельное касание», «Экипировка»). Используйте это, когда пользователь спрашивает, как работает ключевое слово или что написано в его правилах. Отличается от get_glossary — этот инструмент предназначен специально для ключевых слов с текстом правил.

Параметры

namestringобязательный
Название ключевого слова для поиска (без учёта регистра). Примеры: "Flying", "Equip", "Scry".

get_prices

Находит текущие рыночные цены для одной или нескольких карт Magic. Возвращает цены в USD, USD Foil, EUR и MTGO tix из Scryfall. Используй это, когда пользователь спрашивает о ценах на карты, стоимости колоды или хочет сравнить стоимость карт.

Параметры

namesstring[]обязательный
Названия карт для поиска цен (1-50)

get_rulings

Получает официальные разъяснения для конкретной карты Magic. Применяйте этот инструмент, когда пользователь спрашивает о конкретных взаимодействиях, крайних случаях или поведении карты в необычных ситуациях. Возвращает разъяснения с отметками времени от Wizards of the Coast.

Параметры

card_namestringобязательный
Название карты для получения разъяснений

lookup_rule

Находит конкретную секцию Всеобъемлющих правил Magic: The Gathering по номеру раздела (например, «702», «702.1») или ищет текст правил. Используй, когда пользователь спрашивает о конкретных правилах игры, взаимодействиях правил или нуждается в официальном тексте правила. Возвращает правило и его подразделы.

Параметры

querystring
Текст для поиска по всем заголовкам правил и тексту правил (без учёта регистра).
sectionstring
Номер раздела правил для поиска (например, «702» или «702.1»). Возвращает точное совпадение и все подразделы.

search_by_mechanic

Находит карты с определённым ключевым словом или механикой (например, "Flying", "Trample", "Scry", "Cascade"). Используйте это, когда пользователь спрашивает о картах с конкретной способностью или механикой. При необходимости включает официальное определение этого ключевого слова из правил.

Параметры

formatstring
Фильтрует по легальности формата.
include_definitionboolean
Включает определение ключевого слова из таблицы ключевых слов.
keywordstringобязательный
Ключевое слово или механика для поиска (например, "Flying", "Trample")
limitnumber
Максимум результатов (по умолчанию: 5, максимум: 20)

search_cards

Поиск карт Magic: The Gathering по названию, типу, цвету, мана-стоимости, редкости, набору, легальности в формате или ключевому слову. Используйте, когда нужно найти карты, соответствующие конкретным критериям. Поддерживает полнотекстовый поиск по названиям карт, строкам типа и тексту Оракула. Возвращает сводный список - для полной информации по конкретной карте используйте get_card.

Параметры

cmcnumber
Фильтрует по конвертированной мана-стоимости.
cmcOpenum
Оператор сравнения CMC (по умолчанию: eq)
colorsstring[]
Фильтрует по цветам (JSON-массив содержит все указанные)
formatstring
Фильтрует по легальности формата (правовому статусу).
keywordstring
Фильтровать по ключевому слову в JSON-массиве keywords
limitnumber
Максимум результатов (по умолчанию: 5, максимум: 20)
namestring
Фильтрует по названию карты (совпадение по LIKE)
querystring
Выполняет полнотекстовый поиск (FTS5) по полям name, type_line и oracle_text.
raritystring
Фильтрует по редкости (обычная, необычная, редкая, мифическая).
setstring
Фильтр по коду набора
typestring
Фильтрует по type_line (совпадение по LIKE).

`0.2.2`основная	04.04.2026
`0.2.1`	16.03.2026
`0.2.0`	15.03.2026
`0.1.0`	15.03.2026

Выберите клиент, чтобы установить gregario/mtg-oracle:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "gregario-mtg-oracle-dphj82lusm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mtg-oracle"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"gregario-mtg-oracle-dphj82lusm\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mtg-oracle\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add gregario-mtg-oracle-dphj82lusm -- npx -y mtg-oracle

Либо через JSON-конфиг:

claude mcp add-json gregario-mtg-oracle-dphj82lusm "{\"command\":\"npx\",\"args\":[\"-y\",\"mtg-oracle\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add gregario-mtg-oracle-dphj82lusm -- npx -y mtg-oracle

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.gregario-mtg-oracle-dphj82lusm]
command = "npx"
args = ["-y", "mtg-oracle"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите gregario/mtg-oracle, а в поле команды запуска — строку ниже:

npx -y mtg-oracle

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "gregario-mtg-oracle-dphj82lusm": {
      "command": "npx",
      "args": [
        "-y",
        "mtg-oracle"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например gregario-mtg-oracle-dphj82lusm.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: gregario-mtg-oracle-dphj82lusm
    command: npx
    args:
      - "-y"
      - "mtg-oracle"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "gregario-mtg-oracle-dphj82lusm": {
      "command": "npx",
      "args": [
        "-y",
        "mtg-oracle"
      ]
    }
  }
}

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 4
Форков на Github: 1
Загрузок: 1 590
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 08:01
Идентификатор: H7WJhviILU6aUiAY
Категории: Игры и геймификация

gregario/mtg-oracle

mtg-oracle

Installation

Claude Desktop Configuration

Похожие MCP-сервера

gregario/lorcana-oracle

gregario/onepiece-oracle

gregario/hearthstone-oracle

sailorpepe/undesirables-mcp-server

gregario/dnd-oracle

alex-gon/thegamecrafter-mcp-server