Godot MCP Server Integration

What does “Godot” MCP Server do?

Godot MCP Server is a Model Context Protocol (MCP) server designed to interface with the Godot game engine. It provides tools that allow AI assistants and developers to interact programmatically with Godot, automating various development and debugging workflows. With this server, users can launch the Godot editor, run Godot projects, and capture debug output directly through AI-driven workflows or automation tools. The Godot MCP Server streamlines integration between AI agents and the Godot engine, enhancing productivity for game developers by exposing core editor and runtime functionalities as programmable actions accessible via MCP.

List of Prompts

No information about prompt templates is available in the repository.

List of Resources

No explicit MCP resources are listed in the repository.

List of Tools

• Launch Godot Editor: Provides the ability to start the Godot editor from an external command, allowing integration with development workflows.
• Run Godot Project: Enables launching or running a Godot project directly, facilitating rapid iteration and testing.
• Capture Debug Output: Offers functionality to capture and stream debug output from running Godot processes, useful for monitoring and troubleshooting.

Use Cases of this MCP Server

• Automated Project Launching: Developers can automate the process of launching Godot projects, improving productivity and reducing context switching between tools.
• AI-Assisted Debugging: AI agents can capture and analyze debug output from Godot projects, helping to identify errors and suggest fixes in real-time.
• Remote Editor Control: The server enables remote or headless control of the Godot editor, making it possible to integrate with CI pipelines or cloud-based development environments.
• Workflow Integration: By exposing Godot actions as MCP tools, developers can integrate Godot commands into broader AI-assisted workflows, such as code review bots or project setup scripts.

How to set it up

Windsurf

1. Ensure you have Node.js installed.
2. Locate your Windsurf configuration file.
3. Add the Godot MCP server to the mcpServers section using the JSON snippet below.
4. Save your configuration and restart Windsurf.
5. Verify the MCP server is running and accessible.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@godot/mcp-server@latest"]
    }
  }
}

Claude

1. Install Node.js if not already installed.
2. Open Claude’s configuration file.
3. Insert the following MCP server block under mcpServers.
4. Save and restart Claude.
5. Check that the server is connected.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@godot/mcp-server@latest"]
    }
  }
}

Cursor

1. Install Node.js.
2. Find Cursor’s configuration file.
3. Add the MCP server configuration as below.
4. Save, restart Cursor, and confirm server availability.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@godot/mcp-server@latest"]
    }
  }
}

Cline

1. Ensure Node.js is present on your system.
2. Edit the Cline config file.
3. Add the Godot MCP server JSON snippet.
4. Save changes, restart Cline, and verify the setup.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["@godot/mcp-server@latest"]
    }
  }
}

Note:
To secure API keys or sensitive credentials, use environment variables in your configuration. Example:

{
  "env": {
    "GODOT_API_KEY": "${GODOT_API_KEY}"
  },
  "inputs": {
    "projectPath": "/path/to/your/project"
  }
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "godot-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “godot-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

Godot MCP provides a focused but narrow set of powerful integrations for Godot developers. It’s well-licensed (MIT), maintained, and offers clear setup instructions, but lacks explicit prompt/resource definitions and sampling/roots support. For Godot-centric automation, it’s practical and mature. Score: 6/10.

MCP Score