---

AIGC: ContentProducer: Minimax Agent AI ContentPropagator: Minimax Agent AI Label: AIGC ProduceID: "00000000000000000000000000000000" PropagateID: "00000000000000000000000000000000" ReservedCode1: 30440220272e9c26d48e4b2e68c85309a4b16e9d819d9edbbd42b1ba8702b03a8b96afc402201d6e8c78e678951411edecabb05d806ae4c235f24287a25a5ea7a93a67e348c4 ReservedCode2: 3045022100caa3fe17901c14aa5782bbb3b1a7b98626ceac25216f17f8f7315ef1bdf0d219022024cc1d8e1dd32a5d5bb5de66506ae8303c6a823851e1e4fc3bb218dc797a702d

Godot MCP Server

一个用于 Godot GDScript 自动化检查的 MCP 服务器。

功能

• gdlint - 检查 GDScript 文件
• gdformat - 格式化代码
• godot_export_validate - 导出验证依赖错误
• godot_check_all - 执行完整检查
• godot_get_errors - 读取错误日志

安装

cd godot-mcp
npm install

配置

设置 Godot 可执行文件路径（可选，默认使用系统 PATH 中的 godot）：

# Godot 可执行文件路径
export GODOT_BIN=/usr/bin/godot4

在 Claude Code 中使用

在 claude_code_settings.json 中添加：

{
  "mcpServers": {
    "godot-check": {
      "command": "node",
      "args": ["/path/to/godot-mcp/index.js"],
      "env": {
        "GODOT_BIN": "/usr/bin/godot4"
      },
      "alwaysAllow": ["gdlint", "gdformat", "godot_export_validate", "godot_check_all", "godot_get_errors"]
    }
  }
}

使用示例

所有工具都支持通过 project 参数指定项目路径（可选，默认当前目录）：

# 检查单个文件（使用默认当前目录）
godot-check gdlint {"file": "res://scripts/player.gd"}

# 检查指定项目中的文件
godot-check gdlint {"file": "res://scripts/player.gd", "project": "/path/to/project"}

# 检查所有文件
godot-check gdlint {"all": true, "project": "/path/to/project"}

# 格式化文件
godot-check gdformat {"file": "res://scripts/player.gd"}

# 完整检查（lint + format + export）
godot-check godot_check_all {"project": "/path/to/project"}

# 导出验证
godot-check godot_export_validate {"project": "/path/to/project", "preset": "Web"}

路径处理

• 如果 project 是相对路径，会自动转换为绝对路径（基于当前工作目录）
• 如果 project 是绝对路径，直接使用
• 文件路径可以是相对路径（相对于项目目录）或绝对路径
• 项目路径会被验证是否存在

自动清理

服务器会自动清理临时导出的 pack 文件，无需手动处理。