
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
概覽
本機 MCP 伺服器,讓助理查詢《戰鎚 40K》與 Kill Team 的規則、單位資料表、策略、分遣隊和回合流程。
- 可以做什麼
- 查詢單位資料表、關鍵字與規則,可依陣營和版本篩選
- 依名稱、陣營、關鍵字、能力文字或分數搜尋並比較單位
- 查詢策略、分遣隊、強化、Kill Team 計謀與遠征內容
- 說明回合順序與階段,或依目前階段提示下一步
- 計算攻擊配置的期望傷害,支援重擲、武器關鍵字、無敵豁免與無視傷痛
- 在 11 版配對戰中依雙方部隊傾向判定主要任務
- 適用情境
- 適合在組軍、規則爭議或學習階段流程時,讓助理直接回答《戰鎚 40,000》(10 版或 11 版)、戰鬥巡邏或 Kill Team 的規則問題,不必離開對話。
- 執行需求
- 以本機程序執行,透過 npx 或全域 npm 安裝,需要 Node.js 與 npm。未宣告帳號、API 金鑰、環境變數或請求標頭。資料於建置時內嵌,執行時不需連網。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Warhammer Oracle,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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.
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
Or install globally:
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
Claude Code
Tools
lookup_unit
Look up a unit datasheet by name. Returns stat profiles, unit size (model count), ranged and melee weapons, abilities, and keywords.
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.
Parameters: keyword (required), game_mode (optional)
lookup_phase
Look up a game phase by name. Returns step-by-step instructions and tips.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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
To refresh unit data from BSData:
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版本歷史
1- v0.1.1最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分