Godot MCP
Godot MCP
**Coding-Solo/godot-mcp**의 커밋
1209744(MIT)에서 포크되었습니다. 이 포크는 @jamesdowzard가 독립적으로 유지 관리하며, Android 내보내기 검증기 지원 및 기타 AI 친화적인 도구를 추가했습니다. 업스트림 포크 관계는 git 수준에서 단절되었으며, 저작권/귀속은 MIT 라이선스에 따라 보존됩니다.
((((((( (((((((
((((((((((( (((((((((((
((((((((((((( (((((((((((((
(((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((
((((( ((((((((((((((((((((((((((((((((((((((((( (((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
(((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
(((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
(((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
(((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((((((((((((((((
(((((((((((((((((((((((((((((((((
/$$ /$$ /$$$$$$ /$$$$$$$
| $$$ /$$$ /$$__ $$| $$__ $$
| $$$$ /$$$$| $$ \__/| $$ \ $$
| $$ $$/$$ $$| $$ | $$$$$$$/
| $$ $$$| $$| $$ | $$____/
| $$\ $ | $$| $$ $$| $$
| $$ \/ | $$| $$$$$$/| $$
|__/ |__/ \______/ |__/Godot 게임 엔진과 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.
소개
Godot MCP를 사용하면 AI 에이전트가 Godot 에디터를 실행하고, 프로젝트를 구동하며, 디버그 출력을 캡처하고, 프로젝트 실행을 제어할 수 있습니다. 이러한 직접적인 피드백 루프는 에이전트가 실제 Godot 프로젝트에서 무엇이 작동하고 무엇이 작동하지 않는지 이해하도록 도와주어, 더 나은 코드 생성 및 디버깅 지원을 가능하게 합니다.
Related MCP server: Gear
주요 기능
Godot 에디터 실행: 특정 프로젝트에 대한 Godot 에디터 열기
Godot 프로젝트 실행: 디버그 모드에서 Godot 프로젝트 실행
디버그 출력 캡처: 콘솔 출력 및 오류 메시지 검색
실행 제어: 프로그래밍 방식으로 Godot 프로젝트 시작 및 중지
Godot 버전 확인: 설치된 Godot 버전 검색
Godot 프로젝트 목록: 지정된 디렉토리에서 Godot 프로젝트 찾기
프로젝트 분석: 프로젝트 구조에 대한 상세 정보 획득
씬 관리:
지정된 루트 노드 유형으로 새 씬 생성
사용자 정의 속성을 사용하여 기존 씬에 노드 추가
Sprite2D 노드에 스프라이트 및 텍스처 로드
3D 씬을 GridMap용 MeshLibrary 리소스로 내보내기
변형 생성 옵션을 포함하여 씬 저장
UID 관리 (Godot 4.4 이상):
특정 파일의 UID 가져오기
리소스를 다시 저장하여 UID 참조 업데이트
요구 사항
시스템에 설치된 Godot Engine
Node.js (>=18.0.0) 및 npm
MCP를 지원하는 AI 에이전트
빠른 시작
Claude Code
claude mcp add godot -- npx @coding-solo/godot-mcp이제 끝입니다. Claude Code를 다시 시작하면 Godot MCP 도구를 사용할 수 있습니다.
환경 변수 사용 시:
claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcpCline MCP 설정 파일(~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json)에 추가하세요:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["@coding-solo/godot-mcp"],
"env": {
"DEBUG": "true"
},
"disabled": false,
"autoApprove": [
"launch_editor",
"run_project",
"get_debug_output",
"stop_project",
"get_godot_version",
"list_projects",
"get_project_info",
"create_scene",
"add_node",
"load_sprite",
"export_mesh_library",
"save_scene",
"get_uid",
"update_project_uids"
]
}
}
}Cursor UI 사용:
Cursor 설정 > 기능(Features) > MCP로 이동
+ Add New MCP Server 버튼 클릭
양식 작성:
이름:
godot유형:
command명령어:
npx @coding-solo/godot-mcp
"Add" 클릭
MCP 서버 카드 우측 상단의 새로고침 버튼을 눌러 도구 목록을 불러와야 할 수 있습니다.
프로젝트별 설정 사용:
프로젝트 디렉토리에 .cursor/mcp.json 파일을 생성하세요:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["@coding-solo/godot-mcp"],
"env": {
"DEBUG": "true"
}
}
}
}MCP 호환 클라이언트의 경우 다음 설정을 사용하세요:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["@coding-solo/godot-mcp"],
"env": {
"GODOT_PATH": "/path/to/godot",
"DEBUG": "true"
}
}
}
}환경 변수
변수 | 설명 |
| Godot 실행 파일 경로 (자동 감지보다 우선함) |
| 상세 서버 측 디버그 로깅을 활성화하려면 |
git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build그런 다음 npx 대신 MCP 클라이언트가 build/index.js를 가리키도록 설정하세요.
아키텍처
Godot MCP 서버는 복잡한 작업을 위해 번들된 GDScript 방식을 사용합니다:
직접 명령어: 에디터 실행이나 프로젝트 정보 가져오기와 같은 간단한 작업은 Godot의 내장 CLI 명령어를 직접 사용합니다.
번들 작업 스크립트: 씬 생성이나 노드 추가와 같은 복잡한 작업은 모든 작업을 처리하는 단일 포괄적 GDScript 파일(
godot_operations.gd)을 사용합니다.
번들된 스크립트는 작업 유형과 매개변수를 JSON으로 받아, 작업마다 임시 파일을 생성하지 않고도 유연하고 동적인 작업 실행을 가능하게 합니다.
문제 해결
Godot을 찾을 수 없음:
GODOT_PATH환경 변수를 Godot 실행 파일 경로로 설정하세요.연결 문제: 서버가 실행 중인지 확인하고 AI 어시스턴트를 다시 시작하세요.
잘못된 프로젝트 경로: 경로가
project.godot파일이 포함된 디렉토리를 가리키는지 확인하세요.빌드 문제:
npm install을 실행하여 모든 종속성이 설치되었는지 확인하세요.
MCP 서버가 Cursor 설정(설정 > MCP)에 표시되고 활성화되어 있는지 확인하세요.
MCP 도구는 에이전트 채팅 프로필(Cursor Pro 또는 Business 구독)에서만 실행할 수 있습니다.
"Yolo 모드"를 사용하여 MCP 도구 요청을 자동으로 실행하세요.
라이선스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
Available Tools
14 toolsadd_nodeB
Add a node to an existing scene
Inputs: projectPath (required), scenePath (required), nodeType (required), nodeName (required), +2 more.
create_sceneA
Create a new Godot scene file
Inputs: projectPath (required), scenePath (required), rootNodeType.
export_mesh_libraryB
Export a scene as a MeshLibrary resource
Inputs: projectPath (required), scenePath (required), outputPath (required), meshItemNames.
get_debug_outputB
Get the current debug output and errors
Inputs: no named parameters.
get_godot_versionA
Get the installed Godot version
Inputs: no named parameters.
get_project_infoB
Retrieve metadata about a Godot project
Inputs: projectPath (required).
get_uidB
Get the UID for a specific file in a Godot project (for Godot 4.4+)
Inputs: projectPath (required), filePath (required).
launch_editorC
Launch Godot editor for a specific project
Inputs: projectPath (required).
list_projectsA
List Godot projects in a directory
Inputs: directory (required), recursive.
load_spriteC
Load a sprite into a Sprite2D node
Inputs: projectPath (required), scenePath (required), nodePath (required), texturePath (required).
run_projectC
Run the Godot project and capture output
Inputs: projectPath (required), scene.
save_sceneC
Save changes to a scene file
Inputs: projectPath (required), scenePath (required), newPath.
stop_projectA
Stop the currently running Godot project
Inputs: no named parameters.
update_project_uidsB
Update UID references in a Godot project by resaving resources (for Godot 4.4+)
Inputs: projectPath (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have distinct purposes targeting different aspects of Godot project management, scene manipulation, and debugging. However, there is some potential overlap between 'create_scene' and 'add_node' as both involve scene creation/modification, and 'get_debug_output' and 'run_project' both relate to runtime output, though their specific focuses differ enough to avoid major confusion.
The naming follows a consistent verb_noun pattern throughout (e.g., 'add_node', 'create_scene', 'get_debug_output'), which is clear and predictable. There are minor deviations like 'export_mesh_library' using a compound noun and 'update_project_uids' being slightly longer, but overall the convention is well-maintained and readable.
With 14 tools, the count is well-scoped for a Godot MCP server, covering project management, scene editing, debugging, and runtime operations. Each tool appears to earn its place by addressing specific needs in the Godot development workflow, without being overly sparse or bloated.
The tool set provides comprehensive coverage for core Godot operations, including project listing, scene CRUD, debugging, and runtime management. Minor gaps exist, such as the lack of tools for editing node properties directly or handling more advanced resource types, but agents can likely work around these with the available tools for most common tasks.
Maintenance
Related MCP Connectors
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants direct control over Godot 4 game development projects. It enables launching the editor, running projects, creating and editing scenes, writing GDScript, and inspecting assets through natural language commands.444MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to directly run, inspect, modify, and debug Godot game development projects through 110+ tools covering scenes, scripts, resources, runtime debugging, and asset management.333MIT
- AlicenseBqualityDmaintenanceAn enhanced MCP server for interacting with the Godot game engine, enabling AI assistants to launch the editor, run projects, manage scenes and nodes, and handle scripts.16MIT
- AlicenseAqualityCmaintenanceAn MCP server that lets AI coding agents work on Godot 4 projects, including reading and editing scenes, writing and validating GDScript, running the game, and capturing screenshots.2530 npmMIT