# Mcp Server Godot Editor

> MCP server to allow agents to control the Godot editor

- **Type:** MCP server
- **Install:** `agentstack add mcp-fernforestgames-mcp-server-godot-editor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fernforestgames](https://agentstack.voostack.com/s/fernforestgames)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fernforestgames](https://github.com/fernforestgames)
- **Source:** https://github.com/fernforestgames/mcp-server-godot-editor

## Install

```sh
agentstack add mcp-fernforestgames-mcp-server-godot-editor
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-server-godot-editor

A Godot 4.5 editor plugin that implements a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server, enabling AI agents to control the Godot editor.

## Features

The MCP server exposes the following tools:

| Tool | Description |
|------|-------------|
| `take_screenshot` | Captures a screenshot from the running game (returns WebP image) |
| `play_main_scene` | Starts the project's main scene |
| `play_scene` | Starts a specific scene by resource path |
| `stop_playing_scene` | Stops the currently running scene |
| `synthesize_input` | Injects input events into the running game (key, mouse, action, joypad) |
| `click_node` | Simulates a mouse click on a specific node in the running game |
| `hover_node` | Simulates a mouse hover over a specific node in the running game |
| `get_node_tree` | Read the scene tree from a running game |

## Installation

1. Copy the `addons/mcp-server-godot-editor` folder into your Godot project's `addons` directory
2. Enable the plugin in **Project > Project Settings > Plugins**
3. Configure your MCP client to connect to the Godot editor (see below)

## MCP client configuration

The server communicates with MCP clients over Godot's own stdin/stdout. You'll need to launch Godot from the CLI in editor mode, and with the `--no-header` option to disable the initial stdout messages (which would otherwise conflict with MCP messages).

Here's an example `.mcp.json` configuration:

```json
{
  "servers": {
    "godot-editor": {
      "type": "stdio",
      "command": "path/to/godot",
      "args": ["--editor", "--no-header"]
    }
  }
}
```

Note that this plugin must also be enabled in the project settings for the MCP server to start running.

## Architecture

The plugin uses a two-layer communication system:

```
MCP Client  Editor MCP Server  Game Process
```

- **Editor MCP Server**: runs inside the Godot editor, handles JSON-RPC protocol and editor commands
- **Game Process**: the running game instance; receives commands (like screenshot capture) from the editor via Godot's debugger messaging system

## License

Released under the [MIT license](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fernforestgames](https://github.com/fernforestgames)
- **Source:** [fernforestgames/mcp-server-godot-editor](https://github.com/fernforestgames/mcp-server-godot-editor)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-fernforestgames-mcp-server-godot-editor
- Seller: https://agentstack.voostack.com/s/fernforestgames
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.