모델 컨텍스트 프로토콜(MCP)을 사용하여 Godot 엔진과 AI 어시스턴트 간의 포괄적인 통합입니다. 이 플러그인은 AI 어시스턴트가 Godot 프로젝트와 상호작용할 수 있게 하여 코드 지원, 장면 조작, 프로젝트 관리 등 강력한 기능을 제공합니다.

특징

• 완전한 Godot 프로젝트 접근: AI 어시스턴트가 스크립트, 씬, 노드, 프로젝트 리소스에 접근하고 수정할 수 있습니다
• 양방향 통신: 프로젝트 데이터를 AI에 전송하고 제안된 변경 사항을 편집기에서 직접 적용
• 명령 범주:
• 노드 명령어: 씬 내 노드 생성, 수정 및 관리
• 스크립트 명령어: GDScript 파일 편집, 분석 및 생성
• 장면 명령어: 장면과 그 구조를 조작함
• 프로젝트 명령어: 프로젝트 설정 및 리소스 접근
• 편집기 명령어: 다양한 편집기 기능 제어

빠른 설정

1. 저장소 복제

2. MCP 서버 설정

3. Claude 데스크톱 설정

1. Claude Desktop 설정 파일을 편집하거나 생성하기:

2. 다음 구성을 추가하거나 포함된 claude_desktop_config.json를 참고용으로 사용하세요:

Godot MCP (Model Context Protocol)

A comprehensive integration between Godot Engine and AI assistants using the Model Context Protocol (MCP). This plugin allows AI assistants to interact with your Godot projects, providing powerful capabilities for code assistance, scene manipulation, and project management.

Features

• Full Godot Project Access: AI assistants can access and modify scripts, scenes, nodes, and project resources
• Two-way Communication: Send project data to AI and apply suggested changes directly in the editor
• Command Categories:
  • Node Commands: Create, modify, and manage nodes in your scenes
  • Script Commands: Edit, analyze, and create GDScript files
  • Scene Commands: Manipulate scenes and their structure
  • Project Commands: Access project settings and resources
  • Editor Commands: Control various editor functionality

Quick Setup

1. Clone the Repository

git clone https://github.com/ee0pdt/godot-mcp.git
cd godot-mcp

2. Set Up the MCP Server

cd server
npm install
npm run build
# Return to project root
cd ..

3. Set Up Claude Desktop

1. Edit or create the Claude Desktop config file:

   # For macOS
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. Add the following configuration (or use the included claude_desktop_config.json as a reference):

   {
     "mcpServers": {
       "godot-mcp": {
    	 "command": "node",
    	 "args": [
    	   "PATH_TO_YOUR_PROJECT/server/dist/index.js"
    	 ],
    	 "env": {
    	   "MCP_TRANSPORT": "stdio"
    	 }
       }
     }
   }
   

   Note: Replace PATH_TO_YOUR_PROJECT with the absolute path to where you have this repository stored.

3. Restart Claude Desktop

4. Open the Example Project in Godot

1. Open Godot Engine
2. Select “Import” and navigate to the cloned repository
3. Open the project.godot file
4. The MCP plugin is already enabled in this example project

Using MCP with Claude

After setup, you can work with your Godot project directly from Claude using natural language. Here are some examples:

Example Prompts

@mcp godot-mcp read godot://script/current

I need help optimizing my player movement code. Can you suggest improvements?

@mcp godot-mcp run get-scene-tree

Add a cube in the middle of the scene and then make a camera that is looking at the cube.

@mcp godot-mcp read godot://scene/current

Create an enemy AI that patrols between waypoints and attacks the player when in range.

Natural Language Tasks Claude Can Perform

• “Create a main menu with play, options, and quit buttons”
• “Add collision detection to the player character”
• “Implement a day/night cycle system”
• “Refactor this code to use signals instead of direct references”
• “Debug why my player character falls through the floor sometimes”

Available Resources and Commands

Resource Endpoints: