Game Maker Studio 2
MCP Server for Game Maker Studio 2
What is Game Maker Studio 2?
Game Maker Studio 2 is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for game maker studio 2
MCP Server for Game Maker Studio 2
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Server for Game Maker Studio 2
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx gms2Configuration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Game Maker Studio 2
The GMS2 MCP Server parses GameMaker Studio 2 projects and exposes their structure, GML source code, and asset metadata to AI coding assistants through 7 dedicated MCP tools. It enables AI agents to rapidly understand a GMS2 project — including objects, scripts, rooms, sprites and their relationships — without opening the GameMaker IDE. Developers working with Cursor IDE can use this server to accelerate vibe-coding by letting the AI query assets, read event code, and export the full project in human-readable form, then suggest edits or write new GML scripts.
Prerequisites
- Python 3.8 or higher (3.10+ recommended, tested on 3.12)
- A GameMaker Studio 2 project with a .yyp project file
- Cursor IDE with MCP support enabled
- Git for cloning the repository
Clone the repository
Download the GMS2 MCP server source code from GitHub.
git clone https://github.com/Atennebris/gms2-mcp-server.git
cd gms2-mcp-serverCreate a Python virtual environment and install dependencies
Set up an isolated Python environment and install the two required packages: the MCP Python SDK and python-dotenv.
python -m venv venv
# Activate on Windows
venv\Scripts\activate
# Activate on macOS/Linux
source venv/bin/activate
pip install -r requirements.txtFind the absolute path to your GMS2 project
The server requires the absolute path to the folder containing your .yyp file. Note this path — you will need it in the next step. Use forward slashes even on Windows.
# Windows example path:
# C:/Users/YourName/Downloads/MyGame
# macOS/Linux example:
# /Users/yourname/projects/MyGameConfigure Cursor IDE MCP settings
Create a .cursor/mcp.json file in your project root (or edit the global one via Cursor Settings > Tools & Integrations > New MCP Server). Set the path to mcp_server.py and the GMS2_PROJECT_PATH environment variable.
{
"mcpServers": {
"gms2-mcp": {
"command": "python",
"args": ["C:/Users/YourName/Desktop/gms2-mcp-server/mcp-serv/mcp_server.py"],
"env": {
"GMS2_PROJECT_PATH": "C:/Users/YourName/Downloads/MyGame"
}
}
}
}Restart Cursor IDE and verify the server
Restart Cursor IDE after saving the configuration. Open the command palette and check MCP server status — you should see 7 tools available under the gms2-mcp server.
Game Maker Studio 2 Examples
Client configuration
Complete .cursor/mcp.json configuration for the GMS2 MCP server. Replace paths with your actual locations.
{
"mcpServers": {
"gms2-mcp": {
"command": "python",
"args": ["/Users/yourname/gms2-mcp-server/mcp-serv/mcp_server.py"],
"env": {
"GMS2_PROJECT_PATH": "/Users/yourname/projects/MyGame"
}
}
}
}Prompts to try
Example prompts for exploring and developing a GMS2 project with AI assistance.
- "Show my GMS2 project structure and list all asset categories"
- "Read the code for obj_player and explain what each event does"
- "What rooms are in the project and what objects are placed in room_level_1?"
- "Show me the sprite information for spr_hero including its frame count and dimensions"
- "Export all project data to text format so I can review the full codebase"Troubleshooting Game Maker Studio 2
MCP server shows red status or 0 tools in Cursor
Check that the absolute path in 'args' points to mcp_server.py (inside the mcp-serv/ subdirectory, not the repo root) and that the path in GMS2_PROJECT_PATH points to the folder containing your .yyp file. Use forward slashes / on Windows. Restart Cursor after any config change.
Server fails with ImportError or ModuleNotFoundError
Ensure the virtual environment is activated and dependencies are installed: activate venv/Scripts/activate (Windows) or source venv/bin/activate, then run 'pip install -r requirements.txt'. The 'command' in mcp.json must point to the Python executable inside the venv, or dependencies must be installed globally.
Tools return 'project not found' or empty results
Verify GMS2_PROJECT_PATH is the directory that directly contains the .yyp file — not a parent folder or a subfolder. The path must not have a trailing slash. Test by running 'python mcp-serv/mcp_server.py' directly from the repo root with GMS2_PROJECT_PATH set to confirm it starts without errors.
Frequently Asked Questions about Game Maker Studio 2
What is Game Maker Studio 2?
Game Maker Studio 2 is a Model Context Protocol (MCP) server that mcp server for game maker studio 2 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Game Maker Studio 2?
Follow the installation instructions on the Game Maker Studio 2 GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Game Maker Studio 2?
Game Maker Studio 2 works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Game Maker Studio 2 free to use?
Yes, Game Maker Studio 2 is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Game Maker Studio 2 Alternatives — Similar Developer Tools Servers
Looking for alternatives to Game Maker Studio 2? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Game Maker Studio 2 in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Game Maker Studio 2?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.