alexmeckes/godot-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

42 stars 12 forks 품질 80 트렌드 26MIT

Repository Install

alexmeckes/godot-mcp는 [T0]]에서 수입된 MCP 서버 후보입니다

개요

alexmeckes/godot-mcp는 [T0]]에서 수입된 MCP 서버 후보입니다

개요(AI 번역)

godot-mcp는 AI 보조 Godot 4.x 개발을 위한 MCP(모델 Context Protocol) 서버입니다. AI 클라이언트는 .tscn, .gdshader], .tres], .tres, 또는 project.godot] 형식으로 추측하는 대신 Godot 프로젝트를 검사하고 변경하는 구조화된 방법을 제공합니다.

장면 조작, 스크립트 생성, 셰이더 생성, 애니메이션 워크플로우, 입력맵 설정, 오디오 라우팅/플레이 설정, 탐색 설정, UI 구축, 발음 생성, 프로젝트 설정, 라이브 편집기 제어 및 런타임 자동화에 대한 13가지 범주에 걸쳐 **99 도구 **.

함께 맞는 방법

피스	역할
`godot-mcp`	이송의 MCP 서버 AI 클라이언트가 호출 할 수있는 도구 표면 노출.
`addons/godot_ai_bridge`	이 재포에 묶인 옵션 Godot 플러그인 라이브 편집기 제어, 런타임 입력 자동화 및 스크린 샷에 필요한. ·
`godot-claude-skills`	옵션 동반자 기술 팩. 코드 생성, 장면 디자인, 그늘, 라이브 Godot 작업에 대한 지식과 워크플로우 레이어를 추가합니다. 고급 `godot-interactive`]] persistent 편집기/runtime 루프에 대한 기술이 포함되어 있습니다. ·

추천 동반자: 이 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 MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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