GM-Maker MCP Server

Build GameMaker projects with AI in Cursor

An MCP (Model Context Protocol) server that brings GameMaker Studio development directly into your AI-powered workflow. Create YYP projects, add scripts, objects, and sprites using natural language in Cursor IDE.

🎮 What This Does

This server exposes GameMaker project manipulation as MCP tools, letting you:

• Create new GameMaker YYP projects from scratch
• Add GML scripts with your code
• Create objects with event definitions
• Import sprite animations from image sequences
• List and manage project resources
• Maintain proper YYP/YY file structure automatically

All through natural language conversations with AI in Cursor.

🙏 Attribution

This project is built on the excellent work by Butterscotch Shenanigans, the indie game studio behind Crashlands, Levelhead, and other amazing games. They've open-sourced their entire GameMaker tooling suite called Stitch.

Specifically, this MCP server uses:

• @bscotch/yy - Robust parsing and writing of GameMaker YY/YYP files
• Their extensive TypeScript type definitions for GameMaker resources
• Their battle-tested approach to programmatic GameMaker project manipulation

Without their incredible open-source contributions to the GameMaker ecosystem, this project wouldn't be possible. Thank you, Butterscotch Shenanigans! 🧈

💡 How This Was Made

Origin Story

This MCP server was created while building Soulbound, a game project that needed better AI-assisted GameMaker development workflows in Cursor. The goal was simple: make Cursor understand GameMaker projects so it could help write GML code, create objects, and manage resources without breaking the YYP structure.

Instead of manually creating GameMaker resources and switching between the IDE and Cursor, this tool lets you stay in the AI-powered flow and have Cursor handle the tedious project setup work.

Technical Architecture

This MCP server bridges GameMaker Studio development with modern AI-assisted workflows:

1. Foundation: Built on Butterscotch's @bscotch/yy library, which provides safe, validated reading and writing of GameMaker's JSON-like YY/YYP file formats.

2. MCP Protocol: Implements the Model Context Protocol from Anthropic, which allows AI assistants to call structured tools via a standard interface.

3. Cursor Integration: Configured to run as a stdio-based MCP server that Cursor can launch and communicate with, exposing GameMaker operations as callable tools.

4. Type Safety: Written in TypeScript with full type definitions from the @bscotch packages, ensuring robust file generation.

5. Architecture: Each tool (create_project, add_script, etc.) follows a consistent pattern:

   • Validate parameters with Zod schemas
   • Load existing YYP or create new project structure
   • Generate proper YY resource files
   • Update YYP resource registry
   • Write everything back using Butterscotch's safe write methods

The result: You can now say "create a player object with a step event" in Cursor, and the AI will generate a proper GameMaker object with all the right YY file structure, registered in the YYP, ready to open in GameMaker Studio.

Born from real game development needs, this tool makes AI-assisted GameMaker development actually practical.

Features

Available Tools

• create_project - Scaffold a new .yyp project
• add_script - Create a GML script and register it in the YYP
• add_object - Create a .yy object with optional event stubs
• add_sprite_from_images - Import frames from a directory and register a sprite
• list_resources - Enumerate resources by type (scripts, objects, spr

... View full README on GitHub