一个面向项目的本地 GameMaker Studio MCP 服务器。它为 MCP 客户端提供了对 .yyp 项目的结构化访问：检查、静态分析、受保护编辑、对象/房间/着色器操作、快照、验证以及官方 Igor 构建。

服务器使用稳定的 @modelcontextprotocol/sdk v1 行，覆盖在 stdio。它不绑定网络端口。文件操作仅限于一个配置的项目内，现有文本文件使用 SHA-256 乐观并发并存及备份。

精彩片段

• 165个MCP工具，25个可重复使用的工作流程提示，以及6个项目资源;
• 零配置工作区自动检测（在你的AI客户端中打开任意GameMaker项目文件夹）;
• CLI 安装和管理器（[gamemaker-mcp install、doctor、connect），支持 20 个 AI 客户端和集成环境（Amp、Antigravity、Claude、Cline、Codex、Copilot、Cursor、Factory、Gemini CLI、Goose、Grok、Junie、Kiro、LM Studio、opencode、Qodo、Qwen、VS Code、Warp、Windsurf）;
• 对GameMaker .yyp/.yy 类JSON文件的容忍解析，包括后尾逗号;

GameMaker MCP Server

A project-aware local MCP server for GameMaker Studio. It gives an MCP client structured access to a .yyp project: inspection, static analysis, guarded editing, object/room/shader operations, snapshots, validation, and official Igor builds.

The server uses the stable @modelcontextprotocol/sdk v1 line over stdio. It does not bind a network port. File operations stay inside one configured project, and existing text files use SHA-256 optimistic concurrency plus backups.

Highlights

• 165 MCP tools, 25 reusable workflow prompts, and 6 project resources;
• zero-config workspace auto-detection (open any GameMaker project folder in your AI client);
• CLI installer & manager (gamemaker-mcp install, doctor, connect) supporting 20 AI clients & IDEs (Amp, Antigravity, Claude, Cline, Codex, Copilot, Cursor, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo, Qwen, VS Code, Warp, Windsurf);
• tolerant parsing of GameMaker .yyp/.yy JSON-like files, including trailing commas;
• project, asset, room, object-event, object-inheritance, sprite, sound, sequence, font, tileset, animation curve, timeline, included data files, audio/texture groups, and shader inspection;
• GML symbol/complexity diagnostics, FPS profiler, i18n scanner, draw state auditor, health score (0-100%), object hierarchy tree, doc exporter, state machine visualizer, dead GML code detector, global variable scanner, physics auditor, asset cross-referencer, and duplicate code finder;
• preflight GML syntax validator (gm_gml_validate_snippet), Igor diagnostic compiler (gm_project_compile_errors), GML Unit Test suite runner (gm_test_runner_run), and Feather JSDoc generator (gm_gml_docgen);
• exact GML patch previews and guarded writes;
• GameMaker folder, object, script, shader, object-event, timeline, test suite, data file, font configuration, tileset configuration, room-setting, room layer, room instance transform, and room-creation-code operations;
• integrity-checked project snapshots and guarded restoration;
• GML Finite State Machine, Particle System, GUI layout, and Inventory system boilerplate generators, plus a GML Unit Testing Framework scaffold;
• synchronous compile/run plus persistent background Igor Compile/PackageZip jobs, status, wait, and cancellation;
• automatic GameMaker runtime and Igor.exe discovery;
• project-root path sandbox, symlink/junction checks, per-file limits, read-only mode, and build opt-in.

Requirements