TG

tomyud1/godot-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

448 stars 52 forks 质量 87 趋势 35MIT

tomyud1/godot-mcp 是从 https://github.com/tomyud1/godot-mcp. 导入的 MCP 服务器候选

概览

tomyud1/godot-mcp 是从 https://github.com/tomyud1/godot-mcp. 导入的 MCP 服务器候选

概述(AI 翻译)

请给你的AI助手完全访问Godot编辑器。

用Claude、光标或任何兼容MCP的AI更快构建游戏——无需复制粘贴,无需上下文切换。AI直接读取、写入并操作你的场景、脚本、节点和项目设置。

Godot 4.4+ ·69 个工具 ·撤销/重做 ·交互式项目可视化工具 ·MIT 许可

**现在在Godot资源商店以Godlink主界面发布。**如果对你有帮助,请在那里留下评论。这是其他Godot开发者找到它的主要途径。


快速启动

0.安装Node.js(一次性设置)

下载并运行安装程序,使用**nodejs.org*(LTS版本)。这是一个标准安装程序——不需要终端。

1.安装 Godot 插件

Godot 4.7及更新版本: 在 Godot 编辑器中,点击顶部的 Asset Store 标签→搜索 “Godlink” → 找到 “Godlink MCP” →安装。(商店页面)

Godot 4.6及更早版本: 点击 AssetLib 标签→搜索 “mcp” → 找到 “Godot AI 助手工具 MCP” →安装。

手动安装: 将该仓库的 addons/godot_mcp/ 文件夹复制到项目的 addons/ 文件夹中。

然后进入Project → Project Settings → Plugins,并启用Godot MCP插件。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Godot MCP

Give your AI assistant full access to the Godot editor.

Build games faster with Claude, Cursor, or any MCP-compatible AI — no copy-pasting, no context switching. AI reads, writes, and manipulates your scenes, scripts, nodes, and project settings directly.

Godot 4.4+ · 69 tools · Undo/redo · Interactive project visualizer · MIT license

Now on the Godot Asset Store as Godlink MCP. If it helps you, please leave a review there. It’s the main way other Godot developers find it.


Quick Start

0. Install Node.js (one-time setup)

Download and run the installer from nodejs.org (LTS version). It’s a standard installer — no terminal needed.

1. Install the Godot plugin

Godot 4.7 and newer: inside the Godot editor, click the Asset Store tab at the top → search “Godlink” → find “Godlink MCP” → Install. (Store page)

Godot 4.6 and older: click the AssetLib tab instead → search “mcp” → find “Godot AI Assistant tools MCP” → Install.

Manual install: copy the addons/godot_mcp/ folder from this repo into your project’s addons/ folder.

Then go to Project → Project Settings → Plugins and enable the Godot MCP plugin.

2. Add the server config to your AI client

Claude Desktop — Settings → Developer → Edit Config → open the config file and paste:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Settings → MCP → Add Server:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — run in terminal:

claude mcp add godot -- npx -y godot-mcp-server

Works with any MCP-compatible client (Cline, Windsurf, etc.)

3. Restart your AI client

Close and reopen Claude Desktop / Cursor / your client so it picks up the new config.

4. Restart your Godot project

Hit Restart Project in the Godot editor. Check the top-right corner — once your AI client is running you should see MCP: Agent Active in green. You’re ready to go.

If it shows MCP: No Agent in orange, Godot found the server but no AI client is using it yet. Restart your AI client. MCP: Disconnected in red means the server isn’t running. Check that Node.js is installed and the config from step 2 is saved.


What Can It Do?

在 GitHub 查看完整 README

安装

npx -y godot-mcp-server
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "godot": { "command": "npx", "args": ["-y", "godot-mcp-server"] } } }