gregario/hearthstone-oracle

gregario/hearthstone-oracle

от gregario
MCP сервер hearthstone-oracle даёт AI доступ ко всем картам Hearthstone и встроенным стратегическим знаниям. Поиск колоды по коду, разбор мана-кривой, архетипов и матч-апов — всё для coaching и сборки сильных колод.

npm version npm downloads Node.js 18+ MCP Compatible MIT License Sponsor hearthstone-oracle MCP server

hearthstone-oracle

Hearthstone MCP server with card search, deck analysis, and strategy coaching. Gives LLMs access to every Hearthstone card plus built-in strategy knowledge for deck building and gameplay advice.

Features

  • Complete card database from HearthstoneJSON — every collectible card, auto-updated
  • Deck decoding and analysis — paste a deck code, get full card list, mana curve, and archetype breakdown
  • Strategy knowledge — archetypes, class identities, matchup dynamics, and game concepts
  • 9 MCP tools — search, lookup, decode, analyze, coach

Quick Start

claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle

Card data is downloaded automatically from HearthstoneJSON on first run and stored locally in ~/.hearthstone-oracle/. No API key required.

Claude Desktop

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

{
  "mcpServers": {
    "hearthstone-oracle": {
      "command": "npx",
      "args": ["-y", "hearthstone-oracle"]
    }
  }
}
Инструменты были проиндексированы:
analyze_deck

Анализирует код колоды Hearthstone: определяет её архетип, объясняет план на игру, выявляет сильные и слабые стороны, прогнозирует динамику матчапов. Используйте этот инструмент для стратегического коучинга по колодам — он объединяет данные о картах со стратегическими знаниями.

Параметры
  • deck_codestringобязательный

    Код колоды Hearthstone (base64 deckstring)

decode_deck

Декодирует код колоды Hearthstone в полный список карт с кривой маны и разбивкой по типам карт. Используйте это, когда пользователь делится кодом колоды и хочет посмотреть, что в ней.

Параметры
  • deck_codestringобязательный

    Код колоды Hearthstone (base64 deckstring)

explain_concept

Объясняет фундаментальную концепцию игры Hearthstone, такую как преимущество по картам, темп, ценность, контроль доски или кривую маны. Включает описание того, как эта концепция применяется именно в Hearthstone.

Параметры
  • namestringобязательный

    Название игровой концепции (например, «темпо», «преимущество по картам», «кривая маны»)

get_archetype

Получает подробное объяснение архетипа колоды Hearthstone (aggro, control, combo, midrange, tempo, value). Включает план игры, условия победы, сильные и слабые стороны и примеры колод. Используйте это, когда объясняете стратегию построения колоды.

Параметры
  • namestringобязательный

    Название архетипа (например, "aggro", "control", "combo", "midrange", "tempo", "value")

get_card

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

Параметры
  • namestringобязательный

    Название карты для поиска (точное или частичное совпадение)

get_class_identity

Получает стратегическую идентичность класса Hearthstone: влияние силы героя, исторические архетипы, сильные и слабые стороны, а также то, как класс подходит к каждой фазе игры. Опустите название класса, чтобы получить обзор всех 11 классов.

Параметры
  • class_namestring

    Название класса (например, «Mage», «Warrior»). Если не указано, будет показан обзор всех классов.

get_keyword

Ищет ключевое слово или механику Hearthstone (например, Battlecry, Deathrattle, Discover) и показывает все карты с таким ключевым словом или механикой. Используйте это, чтобы объяснить, как работает ключевое слово, или найти все карты с определённой механикой.

Параметры
  • namestringобязательный

    Название ключевого слова (например, "Deathrattle", "Battlecry")

  • player_classstring

    Фильтрует связанные карты по классу (например, MAGE, WARRIOR).

get_matchup

Получает теоретическую динамику противостояния между двумя архетипами Hearthstone. Объясняет, кто имеет преимущество, почему, в чём заключается ключевое стратегическое напряжение и на чём каждой стороне следует сосредоточиться.

Параметры
  • archetype_astringобязательный

    Название первого архетипа (например, "aggro", "control")

  • archetype_bstringобязательный

    Название второго архетипа (например, "combo", "midrange")

search_cards

Ищет карты Hearthstone по имени, тексту, классу, стоимости маны, типу, редкости, набору или ключевому слову. Используйте это, когда вам нужно найти карты, соответствующие определённым критериям. Возвращает сводный список - используйте get_card для получения полной информации о конкретной карте.

Параметры
  • card_setstring

    Фильтрует по коду набора (например, CORE, CLASSIC, LOE)

  • collectible_onlyboolean

    Возвращает только коллекционные карты (по умолчанию: true)

  • cost_openum

    Оператор сравнения стоимости: eq, lt, lte, gt, gte (по умолчанию: eq)

  • keywordstring

    Фильтрует по ключевому слову в keywords JSON (например, BATTLECRY, TAUNT, CHARGE).

  • limitnumber

    Максимум результатов для возврата (1–20, по умолчанию 10)

  • mana_costnumber

    Фильтрует по стоимости маны (комбинируйте с cost_op для диапазонных запросов)

  • player_classstring

    Фильтрует по классу (например, MAGE, WARRIOR, NEUTRAL).

  • querystring

    Выполняет полнотекстовый поиск по названию карты и её тексту (использует FTS5).

  • racestring

    Фильтрует по расе/племени миньона (например, BEAST, DRAGON, MURLOC)

  • raritystring

    Фильтровать по редкости: FREE, COMMON, RARE, EPIC, LEGENDARY

  • typestring

    Фильтр по типу карты: MINION, SPELL, WEAPON, HERO, LOCATION

0.1.1основная
0.1.0

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

Любой клиент

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

{
  "mcpServers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}
VS Code

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

{
  "servers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"gregario-hearthstone-oracle-4flffz28o1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"hearthstone-oracle\"]}"
ClaudeClaude 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-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}
Claude CodeClaude Code

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

claude mcp add gregario-hearthstone-oracle-4flffz28o1 -- npx -y hearthstone-oracle

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

claude mcp add-json gregario-hearthstone-oracle-4flffz28o1 "{\"command\":\"npx\",\"args\":[\"-y\",\"hearthstone-oracle\"]}"
CodexCodex

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

codex mcp add gregario-hearthstone-oracle-4flffz28o1 -- npx -y hearthstone-oracle

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

[mcp_servers.gregario-hearthstone-oracle-4flffz28o1]
command = "npx"
args = ["-y", "hearthstone-oracle"]
PerplexityPerplexity

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

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

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: gregario-hearthstone-oracle-4flffz28o1
    command: npx
    args:
      - "-y"
      - "hearthstone-oracle"
Zed

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

{
  "context_servers": {
    "gregario-hearthstone-oracle-4flffz28o1": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}

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

gregario/lorcana-oracle

gregario/lorcana-oracle

от gregario

MCP сервер для поиска карт, анализа колод и обзора франшиз в Disney Lorcana TCG. Полезен коллекционерам и игрокам: ищет карты по параметрам, анализирует распределение чернил и генерацию знаний. Работает на данных LorcanaJSON без API ключей.

TypeScript⭐ 4
gregario/mtg-oracle

gregario/mtg-oracle

от gregario

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

TypeScript⭐ 4
gregario/onepiece-oracle

gregario/onepiece-oracle

от gregario

MCP-сервер для поиска и анализа карт One Piece TCG: ищи карты по тексту, цвету, типу, редкости и сети, анализируй колоду по стоимости и цветам, просматривай всех лидеров и варианты изданий. Инструмент включает поиск контр-карт для защиты. 4348 карт — полезен для построения колод и коллекционирова...

TypeScript⭐ 2
gregario/tft-oracle

gregario/tft-oracle

от gregario

tft-oracle — MCP сервер с точными данными Teamfight Tactics: чемпионы, черты, предметы и усиления. Данные из CommunityDragon обновляются автоматически, предотвращая галлюцинации LLM. Полезен для AI...

TypeScript⭐ 1
hkaanengin/opendota-mcp-server

hkaanengin/opendota-mcp-server

от hkaanengin

MCP сервер для доступа к OpenDota API: 20+ инструментов для запроса статистики игроков, данных матчей и информации о героях Dota 2. Полезен геймерам и аналитикам, поддерживает нечёткий поиск имён г...

Python⭐ 5
sailorpepe/undesirables-mcp-server

sailorpepe/undesirables-mcp-server

от sailorpepe

MCP сервер с 35+ инструментами для локальных вычислений AI-агентов. Оценка карт TCG, генерация медиа, финансовый анализ, аудит кода — всё работает офлайн, без облаков. Подходит для Claude, Cursor и других клиентов.

Python⭐ 3
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин