Provides tools for creating and managing resources in a bound GameMaker Studio 2 project: scripts, objects and events, rooms and instance layers, PNG sprites (including editing existing sprite animation, frame order, durations, speed and origin), PCM WAV sounds, GLSL ES shaders, and multi-level virtual groups. Includes project/resource inspection and reference validation, start-room configuration, plus dry-run previews, conflict detection, per-transaction backups and rollback of changes.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
从编辑项目，到看见运行结果。
让 AI 助手编写 GML、运行游戏、查看画面，并根据结果继续调整。
GameMaker tools for AI agents · Local stdio MCP
76 个工具，覆盖项目制作与运行检查。支持 Codex、Claude Code 等本地 MCP 客户端。
领域 | 支持的操作 |
运行与检查 | 按依赖生成副本，多客户端隔离运行、键鼠测试、状态断言和证据保存 |
代码与场景 | 读写 GML，创建脚本、物体、网络异步事件、房间、实例和瓦片图层 |
美术与音频 | 编辑精灵和纹理组，导入音频与字体，设置流式播放及导出目录 |
显示与资源 | 配置窗口、相机和视口，设置 Windows 导出信息与图标，整理资源 |
修改与恢复 | 预览变更、检测冲突、保存备份并撤销 |
Related MCP server: GM-Maker MCP Server
需要 Windows、Python 3.10+、已在 GameMaker 中创建并保存的项目，以及支持本地 stdio 的 MCP 客户端。以下命令使用 PowerShell。
在用于存放 MCP 的目录执行，将项目路径替换为自己的路径：
python -m venv .venv
$mcpPython = (Resolve-Path '.venv\Scripts\python.exe').Path
& $mcpPython -m pip install morx-gms2-mcp
$gameProject = 'D:\Games\MyGame'
& $mcpPython -m morx_gms2_mcp bind --project $gameProject
& $mcpPython -m morx_gms2_mcp check --project $gameProject--project 接受项目目录或 .yyp 路径。其他安装方式与升级步骤见安装指南。
按客户端选择一条命令：
# Codex
& $mcpPython -m morx_gms2_mcp client-config --project $gameProject --client codex --write
# Claude Code
& $mcpPython -m morx_gms2_mcp client-config --project $gameProject --client claude --write将输出合并到游戏项目的 .codex/config.toml（Codex）或 .mcp.json（Claude Code），保留已有服务，然后重新加载客户端。client-config 只输出配置，不会自动写入配置文件。
连接后调用 server_info 核对绑定项目。上面的 --write 允许修改资源，但修改工具仍默认预览，执行需 dry_run=false；去掉 --write 即保持只读。
本机需安装 Windows x64 GameMaker Runtime，并已登录 GameMaker。为客户端配置增加运行参数（codex 可换为 claude）：
& $mcpPython -m morx_gms2_mcp client-config --project $gameProject --client codex --write `
--allow-run --runtime-root '<Runtime 目录>' --user-directory '<已登录用户目录>'合并配置并重连后，让助手按以下步骤操作：
预览并安装 install_runtime_bridge，在项目中加入可撤销的测试桥接。
调用 run_game，通过 runtime_status 等待 bridge_ready=true。
用 capture_game 查看画面、inspect_game 检查状态，结合输入和日志复现问题。
用 stop_game 清理会话；修改源项目后重新 run_game 验证。
大型项目可先用 inspect_runtime_snapshot 查看复制范围和预计大小；联调多个客户端时用 run_game(new_session=true) 显式新建会话。
多端运行可选 launch_mode="direct"：先编译，再直接启动官方 Runner，编译器会退出。每次启动最长 15 分钟（含准备与编译），runtime_status.lifecycle 显示截止时间；到期自动停止并清理。
仅检查编译可用 compile_game，无需桥接。restart_game 保留测试存档，但使用同一项目快照。完整流程见运行与观察。
耗时事件可用 trigger_game_event(asynchronous=true) 提交，再按请求编号查询 game_request_status，无需重复触发操作。
连接后，把具体任务交给助手：
制作资源 — 将这组 PNG 导入为玩家精灵，设置原点和动画速度，先预览修改。
调整音频 — 检查背景音乐的导出设置，预览改为流式播放，并核对音频组。
验证效果 — 运行游戏，点击开始按钮后截图，读取玩家的 hp 和全局 score；发现问题后修改代码，重新运行验证，最后清理会话。
可复跑的检查使用 run_game_test：组合操作、条件等待和断言，查询结果后导出截图与报告。见场景测试。
支持现代 GMProject v1 项目；运行目标为 Windows VM。已验证 IDE 2026.0.0.16 / Runtime 2026.0.0.23，其他版本需自行验证。
截图和状态由游戏内桥接提供，支持运行中检查；不提供 IDE 操控、原生断点或暂停/逐行调试。默认键鼠输入使用窗口消息，物理鼠标输入需显式选择。
运行使用独立副本和存档，停止后清理。它仍以当前用户权限执行，仅对受信任项目启用 --allow-run。
资源修改直接作用于绑定项目，先保存 IDE 内容，避免同时写入。重命名资源不会改写 GML 中的资源名；结构校验不能代替编译和实际运行检查。
独立社区项目，与 GameMaker 官方无隶属关系。采用 MIT 许可证。
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
AI game maker: build, run, screenshot and play-test Godot and retro console games in a live project
Turn prompts into production-ready game assets: animated characters, textures, terrain, VFX, HUD.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
