用于AI驱动的Godot游戏开发的高级MCP（模型上下文协议）服务器。通过187个强大工具，将像Claude这样的AI助手直接连接到你的Godot编辑器。

建筑

• 实时：WebSocket连接意味着即时反馈，无需文件轮询
• 编辑器集成：完全访问Godot编辑器API、UndoRedo系统和场景树
• JSON-RPC 2.0：标准协议，包含正确的错误代码和建议

这个收回里有什么

⚠️ 此公开仓库仅包含免费的Godot插件/插件。 MCP服务器（Node.js，连接AI助手所需）作为付费套餐的一部分分发——一次性购买，终身更新：

• 请我喝杯咖啡：
• itch.io：

付费压缩包包含插件、带有预构建JavaScript的server/目录、INSTALL.md和AI客户端指令。如果你克隆了这个仓库但没看到server/文件夹，这是预期中的——请从上面的链接下载完整包。

快速启动

1.安装 Godot 插件

把 addons/godot_mcp/ 文件夹复制到 Godot 项目的 addons/ 目录里。

Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 187 powerful tools.

Architecture

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

• Real-time: WebSocket connection means instant feedback, no file polling
• Editor Integration: Full access to Godot’s editor API, UndoRedo system, and scene tree
• JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

What’s in this repo

⚠️ This public repo only contains the free Godot addon/plugin. The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package — one-time purchase, lifetime updates:

• Buy Me a Coffee:
• itch.io:

The paid zip includes the addon, the server/ directory with pre-built JavaScript, INSTALL.md, and AI-client instructions. If you cloned this repo and don’t see a server/ folder, that’s expected — grab the full package from one of the links above.

Quick Start

1. Install the Godot Plugin

Copy the addons/godot_mcp/ folder into your Godot project’s addons/ directory.

Enable the plugin: Project → Project Settings → Plugins → Godot MCP Pro → Enable

2. Install the MCP Server

The server/ directory is only included in the full paid package (see above). After downloading and extracting the zip, run:

cd server
npm install
npm run build

3. Configure Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4. Choose Your Mode

Godot MCP Pro offers four modes to fit any client’s tool limit:

--3d includes the core tools plus physics, AnimationTree and navigation, but omits uid_to_project_path, project_path_to_uid, compare_screenshots, clear_output, close_script, reload_open_scripts, set_anchor_preset and click_button_by_text to stay within the 100-tool cap.

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

Replace --lite with --minimal for the smallest footprint.

• Lite includes: project, scene, node, script, editor, input, runtime, and input_map tools.