godot-mcp-setup

用途

Godot MCP Setup 用于安装和配置 Godot MCP（Model Context Protocol）服务器，使 AI 代理能够以编程方式管理 Godot 场景。该技能属于前置准备类技能，适用于需要场景自动化而非手动逐项编辑的任务。

何时使用

仅在以下情况使用：

用户明确要求基于 MCP 的场景构建
用户希望以编程方式创建或修改场景
用户询问场景自动化工具

除非用户表达对 MCP 功能的兴趣，或替代的手动方式不足以满足需求，否则不应主动建议使用本技能。

主要能力与可用脚本

技能附带脚本 mcp_config_generator.gd，这是一个工具脚本，用于生成 Godot MCP 的 Claude Desktop 配置 JSON。

使用方式与安装流程

第 1 步：检查 MCP 是否已安装

以 PowerShell（Windows）为例，检查 Godot MCP 服务器是否已配置：

# 检查 Godot MCP 服务器是否已配置
$mcpConfigPath = "$env:APPDATA\Claude\claude_desktop_config.json"
if (Test-Path $mcpConfigPath) {
    $config = Get-Content $mcpConfigPath | ConvertFrom-Json
    if ($config.mcpServers.godot) {
        Write-Host "Godot MCP server is already configured."
    }
}

第 2 步：安装 Godot MCP 服务器

安装命令（npx）：

# 全局安装
npm install -g @modelcontextprotocol/server-godot

# 或使用 npx 按需执行
npx @modelcontextprotocol/server-godot

第 3 步：配置 Claude Desktop

MCP 服务器必须注册在 Claude Desktop 的配置文件中。

配置文件位置：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

配置示例：

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

第 4 步：重启 Claude Desktop

配置完成后，用户必须重启 Claude Desktop，MCP 更改才会生效。

验证

安装后，通过检查 mcp_godot_* 工具是否可访问，来验证 MCP 工具是否可用。

常见问题

问题：重启后 MCP 服务器未出现

解决方案：检查 claude_desktop_config.json 中的 JSON 语法
解决方案：确认已安装 Node.js 与 npm

问题：安装过程中出现权限错误

解决方案：在 Windows 上以管理员身份运行 PowerShell

限制与注意事项

在 MCP 配置过程中，应避免以下做法：

不要为简单的场景编辑建议使用 MCP——MCP 面向自动化/批量操作。仅添加单个节点时，应使用手动编辑器。MCP 的额外开销（配置+重启）会浪费时间。
不要跳过 JSON 语法校验——claude_desktop_config.json 中的无效 JSON 会导致 MCP 静默失败。保存前应始终使用 ConvertFrom-Json 校验。
不要忘记提醒用户重启 Claude Desktop——MCP 变更需要完整重启应用，而不仅仅是新建对话。这是用户最常见的错误。
未经用户许可不要使用全局 npm 安装——npm install -g 会修改系统。除非用户明确需要全局安装，否则应优先使用 npx（按需执行）。
不要假设已安装 Node.js——尝试 npx 之前先检查 node --version。缺少 Node 会导致难以理解的 "command not found" 错误。

参考

Godot MCP Server：GitHub 仓库
MCP Protocol：官方文档

技能介绍

用途