
Doom Mcp
io.github.gunnargrosch由 GitHub 账号 gunnargrosch 发布v0.1.3更新于 Oct 24, 2026
Play DOOM via MCP - works with Claude Code, Cursor, and any MCP client
概览
一个本地 MCP 服务器,内嵌真正的 DOOM 引擎,让 AI 助手能玩这款游戏,并在每回合返回状态、敌人和物品信息。
- 可以做什么
- 启动或重新开始 DOOM 游戏,可选择难度、章节和地图,并在每回合后获得游戏状态、敌人情报、附近物品和门的信息。通过按住移动、转向、横移、开火、使用和切换武器等动作并指定 tick 数来推进游戏。将全分辨率截图保存到系统临时目录并在默认图片查看器中打开。既可以逐步指挥助手游玩,也可以让它自主行动。
- 适用场景
- 用于娱乐和实验:在 Claude Code、Cursor 或其他 MCP 客户端中观看或操控 AI 助手玩 DOOM,观察它如何根据收到的状态和缩略图进行导航、瞄准和战斗。
- 运行要求
- 作为本地 stdio 进程运行,通常通过 npm 包以 npx 启动;包含 Windows x64 二进制文件。内置 Freedoom WAD 开箱即用;可通过 DOOM_WAD_PATH 环境变量提供自定义 IWAD。可选通过 DOOM_MCP_DEBUG 开启调试日志。从源码构建需要 Rust 工具链、GCC、Make、Git、curl 和 unzip。
安装
在 SourceWeft 中
- 打开 控制台中的 Doom Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
DOOM via MCP
[MCP Registry] [npm version] [npm downloads] [License: MIT]
Can it run DOOM? Yes - your AI coding assistant can run DOOM.
Play DOOM in Claude Code, Cursor, or any MCP-compatible client. The AI sees the game, fights demons, navigates levels, and reports what's happening - or you direct it move by move.
Read the blog post for the full story.
Table of Contents
- How It Works
- Quick Start
- Play Modes
- Tools Reference
- Configuration
- FAQ
- Architecture
- Development
- Credits
- License
How It Works
A Rust MCP server embeds the real DOOM engine (doomgeneric) directly via FFI. No emulation, no child processes. Each tool call advances the game by a number of ticks and returns:
- Game state - HP, armor, ammo, kills, position, current weapon
- Enemy intel - visible enemies with human-readable direction, distance, and HP
- Nearby items - health, ammo, armor, weapons within pickup range
- Doors and switches - interactable linedefs detected within range
- Frame image - small PNG thumbnail for the AI's vision
The AI uses this information to navigate, fight, and explore. You can direct it or let it play autonomously.
Quick Start
1. Register with your MCP client
Claude Code:
Cursor, Windsurf, or any MCP client - add to .mcp.json:
2. Play
Open a new session and say:
"Let's play DOOM"
The AI will ask which mode you want, start the game on E1M1, and begin playing.
Play Modes
Tools Reference
doom_start
Start or restart DOOM. Safe to call at any time — if a game is already running it restarts cleanly without needing a new session.
doom_action
Advance the game. All listed actions are held simultaneously for the tick duration.
Gameplay notes:
fireholds the trigger for the full duration. Pistol auto-fires every ~10 ticks.- Turn and fire should be separate actions (turning while firing wastes ammo).
useopens doors and activates switches.- Weapon keys: 1=fists, 2=pistol, 3=shotgun, 4=chaingun, 5=rocket launcher, 6=plasma, 7=BFG.
doom_screenshot
Save a full-resolution 320x200 screenshot to the system temp directory and open it in the default image viewer. Does not advance the game (beyond a brief pause for the frame to settle).
Configuration
The bundled Freedoom WAD works out of the box, but the original DOOM shareware WAD has better levels and sprites. To use it:
- Download
DOOM1.WADfrom doomworld.com/classicdoom/info/shareware.php (legal, free) - Set
DOOM_WAD_PATHin your MCP config:
If you own DOOM or DOOM 2, you can use those WADs the same way. To use any custom WAD:
FAQ
Does this work on Windows? Yes. The npm package includes a Windows x64 binary. Register it the same way as on macOS/Linux.
Can I use my own DOOM WAD (DOOM.WAD, DOOM2.WAD)?
Yes. Set DOOM_WAD_PATH in your MCP config. The shareware DOOM1.WAD is free to download from doomworld.com and has much better levels than the bundled Freedoom. See the Configuration section for details.
How much does this cost in API tokens?
Each doom_action call returns ~1-2KB of text (game state + enemy info) plus a ~6KB PNG thumbnail. That's roughly 1,500-2,500 tokens per action. A typical gameplay session of 50 actions uses about 75,000-125,000 tokens.
Can the AI actually play DOOM well? It can navigate levels, find enemies, aim, and fight. It gets about 5-10 kills per session on E1M1 at medium difficulty. It struggles with enemies behind partial cover and navigating complex door sequences. It improves when you direct it.
Can I play a specific level?
Yes. Pass episode and map parameters to doom_start. For example, episode 1 map 3 would be episode:1, map:3.
What happens when I die? The engine reports HP:0 and offers a screenshot of the death screen. Currently there's no restart within a session - start a new conversation to play again.
Does this support multiplayer? Not yet. DOOM's multiplayer protocol could theoretically support multi-agent play, but it's not implemented.
Is the AI cheating? Can it see through walls?
No. Enemy detection uses DOOM's native line-of-sight check (P_CheckSight). The AI only sees enemies that would be visible on screen. Items are detected by proximity but the AI still has to walk over them to pick them up.
Architecture
The binary links the doomgeneric C engine at compile time. At runtime it is a single process with no subprocess spawning. Frames are read from a shared screen buffer and key inputs are injected through FFI.
Virtual time - The engine's clock is decoupled from wall time. Each doomgeneric_Tick() advances exactly one game tic (1/35th of a second), regardless of real elapsed time. This makes gameplay deterministic and prevents ticks from being skipped.
Enemy and item detection - The server iterates the engine's internal object list (thinker_t chain) to find nearby enemies and pickable items. Line-of-sight checks use Doom's native P_CheckSight(). Only visible enemies are reported to prevent "wallhack" cheating.
Development
Requires: Rust toolchain, GCC, Make, Git, curl, unzip.
Register the local build for testing:
Enable debug logging:
npm Package
Build the npm package locally:
Publish (requires npm account + NPM_TOKEN for CI):
Credits
- doomgeneric by ozkl - portable DOOM engine
- Freedoom - open-source IWAD files
- id Software - the original DOOM (GPL-2.0)
Changelog
See CHANGELOG.md for a detailed list of changes.
License
MIT for the MCP server code in this repository.
doomgeneric is GPL-2.0 licensed and is cloned at build time (not vendored). The Freedoom WAD is distributed under a BSD-style license.
来源:README.md,提交 adff214
工具
0版本历史
1- v0.1.3最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分