Warhammer Oracle

Спрашивайте своего ИИ-ассистента о листах данных (datasheets), стратагемах, детачментах, улучшениях, ключевых словах, последовательности фаз, расчете ран и многом другом. Охватывает Warhammer 40,000, Combat Patrol и Kill Team.

Установка

npx warhammer-oracle

Или установите глобально:

npm install -g warhammer-oracle

Related MCP server: dnd-oracle

Конфигурация

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

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

Claude Code

claude mcp add warhammer-oracle -- npx -y warhammer-oracle

Инструменты

lookup_unit

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

"Look up the Intercessor Squad datasheet"
"What are the stats for a Leman Russ Battle Tank?"

Параметры: unit_name (обязательно), faction (опционально), game_mode (опционально: 40k, combat_patrol, kill_team)

lookup_keyword

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

"What does Devastating Wounds do?"
"Explain the Feel No Pain keyword"

Параметры: keyword (обязательно), game_mode (опционально)

lookup_phase

Поиск фазы игры по названию. Возвращает пошаговые инструкции и советы.

"Walk me through the Shooting phase"
"How does the Firefight phase work in Kill Team?"

Параметры: phase_name (обязательно), game_mode (опционально, по умолчанию: 40k)

search_units

Поиск юнитов по названию, фракции или ключевым словам. Возвращает компактный список (макс. 10 результатов) с указанием фракции, очков и ключевых слов.

"Find all Necron units under 100 points"
"Search for units with the Fly keyword"

Параметры: query (обязательно), faction (опционально), max_points (опционально), game_mode (опционально)

compare_units

Сравнение 2-4 юнитов бок о бок. Показывает полные листы данных для каждого юнита в одном ответе.

"Compare Intercessors vs Tactical Marines"
"Compare the Leman Russ, Predator, and Hammerhead side by side"

Параметры: units (обязательно, массив из 2-4 названий юнитов)

game_flow

Показывает полную последовательность хода для игрового режима или подсвечивает, где вы находитесь в ходе и что будет дальше.

"Show me the 40K turn sequence"
"I'm in the Shooting phase — what's next?"
"Show the Kill Team turn sequence"

Параметры: current_phase (опционально), game_mode (опционально, по умолчанию: 40k)

lookup_stratagem

Поиск стратагемы Warhammer 40,000 по названию. Возвращает стоимость в CP, время применения, цель и эффект.

"What does Fire Overwatch do?"
"Show me the Command Re-roll stratagem"

Параметры: name (обязательно), faction (опционально), phase (опционально), detachment (опционально)

search_stratagems

Поиск стратагем по названию, фракции, фазе или детачменту. Возвращает компактный список (макс. 10).

"What stratagems can I use in the Fight phase?"
"Show me Gladius Task Force stratagems"

Параметры: query (обязательно), faction (опционально), phase (опционально), detachment (опционально)

lookup_detachment

Поиск детачмента по названию. Возвращает способность детачмента, доступные улучшения и связанные стратагемы.

"Show me the Gladius Task Force detachment"
"What does the Warhost detachment do for Aeldari?"

Параметры: name (обязательно), faction (опционально)

lookup_enhancement

Поиск улучшения персонажа по названию. Возвращает стоимость в очках, детачмент и эффект.

"What does Adept of the Codex do?"
"Show me Aeldari enhancements"

Параметры: name (обязательно), faction (опционально), detachment (опционально)

lookup_ploy

Поиск уловки (ploy) Kill Team по названию. Возвращает тип (стратегическая/тактическая), стоимость в CP, время применения и эффект.

"What does the Bolster ploy do in Kill Team?"
"Show me Legionaries ploys"

Параметры: name (обязательно), faction (опционально), type (опционально: strategic, tactical)

wound_calculator

Расчет ожидаемого урона для профиля атаки против цели. Учитывает перебросы, ключевые слова оружия (Lethal Hits, Devastating Wounds, Sustained Hits, Torrent), инвульнерабельные спасброски и Feel No Pain.

"Calculate damage: 10 attacks, BS3+, S5 AP-1 D2 vs T4 Sv3+"
"How much damage does a lascannon do to a Leman Russ?"

Параметры: attacks, hit_skill, strength, toughness, armour_save, damage (все обязательно); armour_penetration, invulnerable_save, feel_no_pain, reroll_hits, reroll_wounds, weapon_keywords, wounds_per_model, game_mode (все опционально)

Данные

Все данные встроены во время сборки — никаких сетевых вызовов во время выполнения.

Игровые режимы

• Warhammer 40,000 (40k) — полномасштабные сражения

• Combat Patrol (combat_patrol) — меньший, дружелюбный к новичкам формат

• Kill Team (kill_team) — скирмиш-игра на уровне отряда

Разработка

npm install
npm run build
npm test

Чтобы обновить данные юнитов из BSData:

npm run fetch-data
npm run build

Лицензия

MIT (для кода MCP-сервера).

Данные юнитов получены из проекта сообщества BSData. Игровые правила и правила армий являются интеллектуальной собственностью Games Workshop. Этот инструмент предоставляет справочные данные для личного использования во время игры.