Godot MCP Runtime

@Erodenn

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

Erodenn

提交者

Owen

关于 Godot MCP Runtime

A lightweight MCP server that gives AI assistants direct access to a running Godot 4.x game. Not just file editing, not just scene manipulation. Actual runtime control: input simulation, screenshots, UI discovery, and live GDScript execution while the game is running.

Godot MCP Runtime 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime"
      ],
      "env": {
        "GODOT_PATH": "<path-to-godot-executable>"
      }
    }
  }
}

Godot MCP Runtime 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Godot MCP Runtime?

A lightweight MCP server that gives AI assistants direct access to a running Godot 4.x game. It injects a UDP bridge as an autoload, enabling input simulation, screenshots, UI discovery, and live GDScript execution — no Godot addon required. Designed for AI-driven game development workflows where the agent can check its own work.

How to use Godot MCP Runtime?

Requires Node.js v18+ and Godot 4.x. Install via npx -y godot-mcp-runtime or npm install -g godot-mcp-runtime. Add the command to your MCP client config (Claude Code, Claude Desktop, Cursor) with the GODOT_PATH environment variable (or omit if Godot is on your PATH). Verify by asking the AI to call get_project_info.

Key features of Godot MCP Runtime

Runtime bridge injects a UDP autoload on port 9900
Screenshot capture, batched input simulation, and UI discovery
Live GDScript execution against the active scene tree
Headless scene editing: create scenes, add nodes, attach scripts
Background mode hides the Godot window and blocks physical input
Manual attach mode for CI or externally launched projects

Use cases of Godot MCP Runtime

AI verifying its own changes by running the game and checking output
Automated headless testing of scenes and UI interactions
Live debugging and inspection of a running Godot project
Batch scene operations (add nodes, set properties, save) without opening the editor

常见问题

What distinguishes this from other Godot MCP servers?

No addon installation is required — the server injects a lightweight UDP bridge at runtime and cleans it up automatically. It is analogous to Playwright MCP, but for Godot games.

What are the runtime dependencies?

Node.js v18+ and a Godot 4.x executable. No Godot addon, no project modifications, no additional dependencies.

Where does runtime data live, and how is security handled?

The UDP bridge listens on localhost port 9900 only. The bridge is injected as a temporary autoload and is removed when `stop_project` or `detach_project` is called.

What are the known limitations?

`get_debug_output` is unavailable in manual attach mode because stdout/stderr only flow through processes the MCP server started itself. The server is not a playtesting replacement and cannot assess game feel or fun.

What transport and authentication does the server use?

The server uses MCP stdio transport. No authentication mechanism is mentioned in the README.

其他分类下的更多 MCP 服务器

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K