alexmeckes/godot-mcp

开发工具

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

43 stars 12 forks 质量 77 趋势 20MIT

Repository Install

alexmeckes/Godot-MCP 是一个从 https://github.com/alexmeckes/godot-mcp. 导入的 MCP 服务器候选服务器。

概览

alexmeckes/Godot-MCP 是一个从 https://github.com/alexmeckes/godot-mcp. 导入的 MCP 服务器候选服务器。

概述（AI 翻译）

godot-mcp 是一个用于 AI 辅助 Godot 4.x 开发的 MCP（模型上下文协议）服务器。它为 AI 客户端提供了一种结构化的方式来检查和更改 Godot 项目，而无需猜测 .tscn、.gd、.gdshader、.tres 或 project.godot 格式。

它展示了涵盖13个类别的99个工具，涵盖场景操作、脚本生成、着色器创建、动画工作流程、输入地图设置、音频路由/播放器设置、导航设置、UI构建、程序生成、项目设置、实时编辑器控制和运行时自动化。

它如何拼凑起来

作品	角色
`godot-mcp`	这个仓库里的MCP服务器。暴露了你的AI客户端可以调用的工具表面。
`addons/godot_ai_bridge`	本仓库中捆绑的可选 Godot 插件。用于实时编辑器控制、运行时输入自动化和截图。
`godot-claude-skills`	可选配套技能包。为代码生成、场景设计、着色器和实时 Godot 工作添加知识层和工作流程。包含高级的 `godot-interactive` 技能，用于持久编辑器/运行时循环。

**推荐同伴：**将此MCP与godot-claude-skills配对。godot-mcp提供工具。

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

README

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

Godot MCP Server

godot-mcp is an MCP (Model Context Protocol) server for AI-assisted Godot 4.x development. It gives AI clients a structured way to inspect and change Godot projects instead of guessing at .tscn, .gd, .gdshader, .tres, or project.godot formats.

It exposes 99 tools across 13 categories for scene manipulation, script generation, shader creation, animation workflows, InputMap setup, audio routing/player setup, navigation setup, UI building, procedural generation, project setup, live editor control, and runtime automation.

How It Fits Together

Piece	Role
`godot-mcp`	The MCP server in this repo. Exposes the tool surface your AI client can call.
`addons/godot_ai_bridge`	Optional Godot plugin bundled in this repo. Required for live editor control, runtime input automation, and screenshots.
`godot-claude-skills`	Optional companion skill pack. Adds knowledge and workflow layers for code generation, scene design, shaders, and live Godot work. Includes the advanced `godot-interactive` skill for persistent editor/runtime loops.

Recommended companion: Pair this MCP with godot-claude-skills. godot-mcp provides the tools. The skill pack improves how an agent uses them, especially through its godot-interactive workflow.

Features

File-Based Tools (Always Available)

Scene Tools: Read, write, and manipulate .tscn scene files
Script Tools: Generate and analyze GDScript files
Shader Tools: Create shaders with 11 preset effects (dissolve, outline, hologram, etc.)
Resource Tools: Manage .tres resource files
Animation Tools: Create and edit animation clips, keyframes, and scene animation setup
Input Tools: Manage InputMap actions/bindings and apply control presets
Audio Tools: Create bus layouts and configure AudioStreamPlayer nodes
Navigation Tools: Set up navigation regions, agents, and links in scene files
UI Tools: Create themes, menus, HUDs, dialogs, and responsive layouts
Procedural Generation: Dungeons, tilemaps, and enemy wave configurations

Live Editor Tools (Requires Godot AI Bridge Plugin)

Real-time scene tree inspection
Live node manipulation with undo/redo support
Run/stop scenes directly from your AI assistant
Capture runtime errors and console output
Select nodes in the editor
Drive the running game with synthetic actions, pointer events, and text entry
Capture viewport screenshots from the running game

Documentation

Built-in Godot 4.x class documentation
Searchable API reference for commonly used engine classes

Quick Start

Build the MCP server from source.
Point your MCP client at dist/index.js and pass --project /path/to/your/godot/project.

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": [
        "/path/to/godot-mcp/dist/index.js",
        "--project",
        "/path/to/your/godot/project"
      ]
    }
  }
}