home / mcp / gms2 mcp server

GMS2 MCP Server

MCP Server for Game Maker Studio 2

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "atennebris-gms2-mcp-server": {
      "command": "python",
      "args": [
        "mcp_serv/mcp_server.py"
      ],
      "env": {
        "GMS2_PROJECT_PATH": "YOUR_GMS2_PROJECT_PATH"
      }
    }
  }
}

You run a GameMaker Studio 2 project MCP server inside Cursor IDE to quickly access project structure, GML code, and asset metadata. It exposes practical tools that help developers analyze projects and lets AI agents understand assets without opening GameMaker Studio 2.

How to use

You interact with the MCP server through a Cursor IDE MCP client. Once the server is running, you can ask the AI agent to explore the project, read GML content, examine rooms and objects, or export data in a readable format. Use the available tools to inspect project structure, assets, and relationships without launching the GameMaker editor.

How to install

Prerequisites you need before starting:

- Python 3.8 or newer (3.10+ recommended; tested with 3.12)

- GameMaker Studio 2 project (with a .yyp file) to point the MCP server at

- Cursor IDE with MCP support

Install and run steps

Step 1: Clone the server repository

Step 2: Create and activate a virtual environment

Step 3: Install dependencies

Step 4: Configure Cursor MCP server integration

Step 5: Restart Cursor IDE and initialize MCP servers status

Configuration and runtime

Configure Cursor to start the MCP server from the project root. Use the provided example configuration for a local, stdio-based server that runs Python and points to the MCP script.

{
  "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/Your GMS2 Project"
      }
    }
  }
}

Available tools

scan_gms2_project

Scans the GMS2 project to count assets and locate GML files, giving you a quick overview of structure.

get_gml_file_content

Reads the contents of a specified GML file for inspection or AI analysis.

get_room_info

Provides detailed information about rooms from .yy files, including objects and layouts.

get_object_info

Analyzes objects and their events from .yy files to reveal behavior and relationships.

get_sprite_info

Returns sprite details such as dimensions, frames, and configuration settings.

export_project_data

Exports all project data to a human-readable text format for review or offline analysis.

list_project_assets

Lists all assets by category (Objects, Scripts, Rooms, Sprites, etc.)