Warhammer Oracle

io.github.gregario由 GitHub 账号 gregario 发布v0.1.1更新于 Oct 24, 2026

Warhammer 40K and Kill Team rules, stats, and game flow MCP server

已验证STDIO仅桌面

概览

AI 生成的概览

本地 MCP 服务器,让助手查询《战锤 40K》与 Kill Team 的规则、单位数据表、策略、分遣队和回合流程。

可以做什么
  • 查询单位数据表、关键词与规则,可按阵营和版本筛选
  • 按名称、阵营、关键词、能力文本或分数搜索并对比单位
  • 查询策略、分遣队、强化、Kill Team 计谋与远征内容
  • 讲解回合顺序与阶段,或根据当前阶段提示下一步
  • 计算攻击配置的期望伤害,支持重投、武器关键词、无敌豁免与无视伤痛
  • 在 11 版匹配对战中根据双方部队倾向判定主要任务
适用场景
适合在组军、规则争议或学习阶段流程时,让助手直接回答《战锤 40,000》(10 版或 11 版)、战斗巡逻或 Kill Team 的规则问题,无需离开对话。
运行要求
以本地进程运行,通过 npx 或全局 npm 安装,需要 Node.js 与 npm。未声明账号、API 密钥、环境变量或请求头。数据在构建时内嵌,运行时无需联网。
安装前请注意
规则数据来自 BSData 同步并部分人工整理,可能滞后于官方勘误或版本更新;对局前请以官方资料核对分数与规则。该服务器只读取并返回参考资料,不会修改任何内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Warhammer Oracle,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Warhammer Oracle

Warhammer 40K rules, unit stats, and game flow. An MCP server.

[npm version] [npm downloads] [MIT Licence] [Node.js 18+] [MCP Compatible] [Sponsor] [warhammer-oracle MCP server]


Ask your AI assistant about datasheets, stratagems, detachments, enhancements, keywords, phase sequences, wound math, and more. Covers Warhammer 40,000 (10th and 11th Edition), Combat Patrol, and Kill Team.

[warhammer-oracle MCP server]

Editions: 40K unit/detachment/enhancement lookups default to 11th Edition. Pass game_mode: "40k_10e" to any tool for 10th Edition data instead — 10th Edition support isn't going away. Turn sequences/phases, core keywords, and Core Stratagems are hand-curated from the 11th Edition Core Rules. Detachment-specific stratagems are hand-curated per faction, layered the same way the tabletop rules are layered: an 11th Edition Faction Pack detachment overrides the base Codex where the pack details it in full, and the unrevised Codex baseline applies everywhere else.

Installation

bash
npx warhammer-oracle

Or install globally:

bash
npm install -g warhammer-oracle

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

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

Claude Code

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

Tools

lookup_unit

Look up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords.

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

When a name has different datasheets, the tool lists the matching factions. If a name and faction still have multiple datasheets, it also lists their IDs; pass the faction and one datasheet_id back to select it.

Parameters: unit_name (required), faction (optional), datasheet_id (optional, exact ID shown for same-faction variants), game_mode (optional: 40k/40k_11e (default, 11th Edition), 40k_10e, combat_patrol, kill_team)

lookup_keyword

Look up a keyword or rule. Returns the official definition, a plain English explanation, examples, and which game modes it applies to.

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

Parameters: keyword (required), game_mode (optional)

lookup_phase

Look up a game phase by name. Returns step-by-step instructions and tips.

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

Parameters: phase_name (required), game_mode (optional, default: 40k)

search_units

Search units by name, faction, keywords, or ability text. Returns a compact list (max 10 results) with faction, points, and keywords.

"Find all Necron units under 100 points""Search for units with the Fly keyword""Show me units with Deep Strike"

Parameters: query (required), faction (optional), ability (optional), max_points (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e, combat_patrol, kill_team)

compare_units

Compare 2-4 units side by side. Shows full datasheets for each unit in a single response.

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

Parameters: units (required, array of 2-4 unit names), game_mode (optional: 40k/40k_11e (default), 40k_10e, combat_patrol, kill_team)

game_flow

Show the full turn sequence for a game mode, or highlight where you are in the turn and what comes next.

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

Parameters: current_phase (optional), game_mode (optional, default: 40k)

lookup_stratagem

Look up a Warhammer 40,000 stratagem by name. Returns CP cost, phase timing, target, and effect.

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

Parameters: name (required), faction (optional), phase (optional), detachment (optional)

search_stratagems

Search stratagems by name, faction, phase, or detachment. Returns a compact list (max 10).

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

Parameters: query (required), faction (optional), phase (optional), detachment (optional)

lookup_detachment

Look up a detachment by name. Returns the detachment ability, available enhancements, and associated stratagems.

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

Parameters: name (required), faction (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e)

lookup_enhancement

Look up a character enhancement by name. Returns points cost, detachment, and effect.

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

Parameters: name (required), faction (optional), detachment (optional), game_mode (optional: 40k/40k_11e (default), 40k_10e)

lookup_ploy

Look up a Kill Team ploy by name. Returns type (strategic/tactical), CP cost, timing, and effect.

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

Parameters: name (required), faction (optional), type (optional: strategic, tactical)

wound_calculator

Calculate expected damage output for an attack profile against a target. Handles re-rolls, weapon keywords (Lethal Hits, Devastating Wounds, Sustained Hits, Torrent), invulnerable saves, and 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?"

Parameters: attacks, hit_skill, strength, toughness, armour_save, damage (all required); armour_penetration, invulnerable_save, feel_no_pain, reroll_hits, reroll_wounds, weapon_keywords, wounds_per_model, game_mode (all optional)

determine_primary_mission

Determine each player's Primary Mission from their Force Dispositions (11th Edition Matched Play). Each player's mission is looked up from their opponent's Force Disposition — in a non-mirror matchup, the two players get different missions. Returns mission names only, not full scoring/objective text.

"I picked Take and Hold, my opponent picked Purge the Foe — what are our missions?""What's my Primary Mission if I'm Reconnaissance and they're Priority Assets?"

Parameters: your_disposition, opponent_disposition (both required, one of: Take and Hold, Purge the Foe, Reconnaissance, Priority Assets, Disruption)

lookup_crusade

Look up Crusade content (narrative play). Returns Crusade rules, relics, battle traits, and upgrades.

"What Crusade relics can Space Marines take?""Show me the Crusade battle traits"

Parameters: query (required), faction (optional)

Data

All data is embedded at build time — no network calls at runtime. Data is synced daily from BSData via GitHub Actions.

CategoryCountSource
40K unit datasheets (11th Edition, default)2,695BSData/wh40k-11e
40K unit datasheets (10th Edition)2,666BSData/wh40k-10e
Kill Team operatives519BSData/wh40k-killteam
Detachments (11th / 10th Edition)259 / 208BSData (auto-extracted)
Enhancements (11th / 10th Edition)895 / 827BSData (auto-extracted)
Stratagems1,316Hand-curated (Core Rules + detachment-specific per faction)
Kill Team ploys14Hand-curated (universal + popular factions)
Shared rules (11th / 10th Edition)35 / 33BSData
Shared rules (Kill Team)22BSData
Curated keywords25Hand-written, plain English, 11th Edition Core Rules
Game mode sequences3Hand-curated (40K, Combat Patrol, Kill Team)
Force Disposition mission matchups15Hand-curated (5 dispositions, full grid)

Game modes

  • Warhammer 40,000 (40k / 40k_11e, default) — full-scale battles, 11th Edition rules
  • Warhammer 40,000, 10th Edition (40k_10e) — full-scale battles, 10th Edition rules (permanently supported)
  • Combat Patrol (combat_patrol) — smaller, starter-friendly format
  • Kill Team (kill_team) — squad-level skirmish game

10th Edition support isn't going away when a newer edition is added — every game_mode value, once added, keeps working.

Development

bash
npm installnpm run buildnpm test

To refresh unit data from BSData:

bash
npm run fetch-datanpm run build

License

MIT (for the MCP server code).

Unit data sourced from the BSData community project — wh40k-10e, wh40k-11e, and wh40k-killteam. Game rules and army rules are the intellectual property of Games Workshop. This tool provides reference data for personal use during gameplay.

来源:README.md,提交 47a25ec

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分