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 分