Godot Asset Library에서 "mcp"를 검색하면 Godot 4.7만 해도 19개의 항목이 나오고, 그중 여러 개가 같은 이름을 씁니다. GitHub에는 더 많습니다. 이들 중 Godot 프로젝트에서 나온 것은 없습니다. Godot 프로젝트는 LLM을 엔진에 연결하는 제안을 not planned로 닫았습니다. 그래서 Godot MCP server를 고른다는 것은, 작동 방식이 크게 다르고 지원하는 Godot 버전도 다르며 일부는 심각한 보안 버그가 있었던 커뮤니티 프로젝트 중에서 고르는 일입니다.
저희는 2026년 11월 14일 기준으로 주요 프로젝트를 각자의 저장소, npm 및 PyPI 레지스트리, Asset Library API, GitHub의 advisory 데이터베이스와 대조해 확인했습니다. 가장 많이 쓰이는 Coding-Solo의 godot-mcp도 설치해서 Mac의 Godot 4.7.2에서 실행해 봤습니다.
Godot MCP server가 동작하는 세 가지 방식
| 형태 | Godot에 접근하는 방법 | 에디터 실행 여부 | 예시 |
|---|---|---|---|
| Headless | 각 작업마다 스크립트와 함께 godot 바이너리를 실행합니다 |
아니요 | Coding-Solo/godot-mcp |
| 에디터 플러그인 | 프로젝트의 애드온이 WebSocket 또는 HTTP로 서버와 통신합니다 | 예 | godot-ai, Godlink, Godot MCP Pro, Godot-MCP-Native |
| 에디터 + 런타임 | 에디터용 플러그인과 실행 중인 게임 내부의 autoload | 예, 게임 도구를 쓰려면 게임도 실행 중이어야 합니다 | tugcantopaloglu/godot-mcp, GoPeak |
Headless 방식이 가장 단순합니다. 프로젝트에 설치할 것도, 포트에서 수신 대기할 것도 없습니다. 디스크의 파일을 편집하므로 에디터에서 무엇이 선택되어 있는지, 실행 중인 게임이 어떻게 보이는지는 알 수 없습니다. 플러그인 방식은 이 둘을 모두 할 수 있지만, 프로젝트에 애드온을 두고 로컬 포트를 열어야 하므로 같은 머신의 다른 프로그램도 그 포트와 통신할 수 있습니다. 런타임 방식은 가장 나아가, 에이전트가 실행 중인 게임을 읽고 변경할 수 있게 합니다.
알아둘 만한 서버
| 서버 | Stars | 라이선스 | 형태 | 도구 | Godot | 비고 |
|---|---|---|---|---|---|---|
| Coding-Solo/godot-mcp | 6,640 | MIT | Headless | 14 (실측) | 4.x, UID 도구 4.4+ | npm 0.1.1, 마지막 push 2026년 4월 |
| hi-godot/godot-ai | 3,526 | MIT | 에디터 플러그인 | 46 | 4.7+ | 활발히 개발 중, 2026년 10월에 보안 권고 4건 수정 |
| yurineko73/Godot-MCP-Native | 874 | MIT | 플러그인, GDScript로 작성된 서버 | 155 (README) | 4.6용 Asset Library 등록 | Node나 Python이 필요 없습니다 |
| youichi-uda/godot-mcp-pro | 643 | 애드온 공개, 서버 유료 | 에디터 플러그인 | 187 (README) | 4.4 | 1회 구매 |
| tugcantopaloglu/godot-mcp | 512 | MIT | Headless + 런타임 | 157 (README) | 4.x | npm 패키지가 저장소보다 훨씬 뒤처져 있습니다 |
| tomyud1/godot-mcp (Godlink) | 454 | MIT | 에디터 플러그인 | 69 (README) | 4.4+ | localhost에 바인딩, Asset Store 등록 |
| IvanMurzak/Godot-MCP | 343 | Apache-2.0 | C# 애드온 | 명시 없음 | 4.3~4.7, .NET 빌드 | 기본값이 클라우드 릴레이 |
| ee0pdt/Godot-MCP | 622 | MIT | 에디터 플러그인 | 약 20 | 명시 없음 | 2025년 3월 이후 push 없음, Safety 참고 |
이 목록에 대해 두 가지 주의할 점이 있습니다. 첫째, 이름이 겹칩니다. "Godot MCP"는 서로 무관한 여러 프로젝트의 제목이므로 설치 전에 소유자와, Asset Library에서는 에셋 ID를 확인해야 합니다. 둘째, 라이브러리 버전이 뒤처집니다. Asset Library는 아직 godot-ai 3.2.5를 제공하지만 프로젝트는 4.4.1이며, tugcantopaloglu 포크의 npm 패키지는 1.0.0인데 GitHub에서는 3.1.0입니다.
"godot mcp"로 검색했을 때 나오는 저장소 중 상당수는 Godot MCP 서버가 아닙니다. Blender 스킬 모음과 게임 엔진용 데스크톱 앱도 포함되어 있으며, 그중 하나는 watcher 4명에 31일 만에 1,072 stars를 기록했습니다.
Coding-Solo의 서버, 테스트 결과
Godot가 설치되어 있어야 하고 Node.js 18 이상이 필요합니다. Claude Code에 추가합니다:
claude mcp add godot -- npx @coding-solo/godot-mcp
다른 클라이언트에서는 JSON이 같은 명령입니다:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["@coding-solo/godot-mcp"],
"env": { "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot" }
}
}
}
GODOT_PATH는 서버가 Godot를 찾지 못할 때만 필요합니다. 저희 Mac에서는 서버가 /Applications/Godot.app/Contents/MacOS/Godot를 스스로 찾았습니다. 로그를 더 남기려면 DEBUG=true를 설정합니다.
tools/list가 반환한 14개 도구는 다음과 같습니다: 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.
project.godot 파일 하나만 있는 빈 프로젝트를 만들고 MCP Inspector로 도구를 하나씩 호출했습니다:
| 호출 | 결과 | 시간 |
|---|---|---|
get_godot_version |
4.7.2.stable.official.ed1daf0bf |
6초, 첫 실행에는 npx 다운로드 포함 |
Node2D 루트로 create_scene |
scenes/main.tscn 작성됨 |
2초 |
Player라는 이름의 Sprite2D 타입 add_node |
씬에 노드 추가됨 | 1초 |
get_project_info |
이름, 경로, Godot 버전, 씬 및 스크립트 개수 | 1초 |
존재하지 않는 씬에 add_node |
제안과 함께 isError: true |
1초 |
서버가 작성한 씬 파일은 유효한 Godot 4 형식이었고, root라는 Node2D 아래에 Player라는 Sprite2D가 있었습니다. 오류는 "Use create_scene to create a new scene first" 같은 제안과 함께 제대로 오류로 보고되어, 에이전트가 스스로 복구하는 데 도움이 됩니다.
한 가지 알아둘 점은 성공 응답에 Godot 자체의 콘솔 출력과 전체 인자 목록이 포함된다는 것입니다. 저희의 create_scene 응답은 5,074바이트였고 대부분이 디버그 텍스트였습니다. 몇 번 호출할 때는 문제가 없지만 긴 세션에서는 누적됩니다.
이 서버가 할 수 없는 것은 에디터나 실행 중인 게임을 보는 것입니다. run_project는 게임을 시작하고 get_debug_output은 콘솔을 반환하므로, 에이전트가 실행하고 오류를 읽고 스크립트를 고칠 수는 있지만 화면에 무엇이 있는지는 볼 수 없습니다. 그게 필요하다면 플러그인 기반 서버를 선택합니다.
플러그인 서버
godot-ai(hi-godot)가 가장 활발합니다. 애드온은 addons/godot_ai/에 넣으며, Asset Store 탭이나 릴리스 zip에서 받습니다. Project Settings의 Plugins에서 활성화한 다음, 독의 Configure 버튼으로 사용하는 클라이언트의 설정을 작성합니다. Godot 4.7 이상과 uv가 필요합니다. 클라이언트는 로컬 Python 서버인 godot-ai attach와 인증된 WebSocket을 통해 에디터에 연결합니다. 씬, 노드, 스크립트, 테스트 실행, 로그, 에디터 스크린샷을 다루는 46개의 도구가 있습니다. 새 버전을 기존 애드온 폴더 위에 압축 해제하지 마십시오. README에서는 독의 Update 버튼을 사용하라고 안내합니다.
Godlink(tomyud1)는 Godot 4.4 이상을 지원합니다. 4.7에서는 Asset Store에서, 이전 버전에서는 Asset Library(ID 4767)에서 설치하고, 플러그인을 활성화한 뒤 클라이언트에 npx -y godot-mcp-server를 추가합니다. 에디터의 레이블에 "MCP: Agent Active", "No Agent", "Disconnected"가 표시됩니다. 게임 실행, 입력 전송, 스크린샷 촬영을 포함한 69개의 도구가 있습니다. 편집 내용은 디스크에 기록되므로 에디터의 Ctrl+Z로는 되돌릴 수 없습니다. 대신 자체 mcp_undo가 있습니다.
Godot-MCP-Native는 MCP server 자체를 GDScript로 구현하므로 Node나 Python을 설치할 필요가 없습니다. 포트 9080에서 HTTP로 서비스하며, bearer token은 선택 사항입니다. Godot MCP Pro는 자체 집계 기준으로 도구가 가장 많지만 서버를 별도로 판매합니다.
둘 이상을 사용하면 포트 충돌이 발생할 수 있습니다. Godlink와 Godot MCP Pro는 모두 기본값이 6505이고, ee0pdt와 Godot-MCP-Native는 9080입니다.
보안
게임 프로젝트는 코드이고, 여러 Godot MCP server가 에디터나 게임 안에서 임의의 코드를 실행할 수 있습니다. godot-ai와 tugcantopaloglu의 포크에 있는 game_eval, Godot MCP Pro의 execute_editor_script와 execute_game_script, Godot-MCP-Native의 execute-script, IvanMurzak의 C#용 script-execute가 그렇습니다. 이것이 이 도구들의 존재 이유이며, 동시에 에이전트를 조종하는 프롬프트가 사용자 계정 권한으로 할 수 있는 모든 일을 할 수 있다는 뜻입니다.
GitHub advisory 데이터베이스에 공개된 취약점은 다음과 같습니다.
| 프로젝트 | Advisory | 내용 | 수정 버전 |
|---|---|---|---|
| Coding-Solo/godot-mcp | CVE-2026-25546, high | projectPath를 통한 명령 주입 |
0.1.1 (2026년 2월) |
| GoPeak | GHSA-v24g-v3px-jxv7, high | 도구 인자를 통한 명령 주입 | 2.4.1, GitHub releases에만 배포; npm 패키지는 deprecated |
| hi-godot/godot-ai | 2026년 10월 advisory 4건 | Windows에서 쓰기 차단 목록 우회, 자격 증명 파일 읽기 가능, 스푸핑 가능한 호스트 검사 | 패치 버전은 각 advisory 참고 |
Coding-Solo의 server에는 더 미묘한 문제가 있습니다. 2026년 4월 16일에 병합된 후속 수정은 add_node와 create_scene이 노드 타입으로 주어진 스크립트를 로드하지 못하게 막습니다. 그 스크립트의 코드가 실행될 수 있기 때문입니다. 최신 npm 릴리스인 0.1.1은 2월에 나왔습니다. 새 릴리스가 나오지 않는 한 npm 패키지에는 이 수정이 포함되지 않으며, 저장소에서 설치하면 포함됩니다.
ee0pdt/Godot-MCP는 2025년 3월 이후 커밋이 없습니다. 열린 이슈에 따르면 이 프로젝트의 WebSocket server는 인증 없이 모든 네트워크 인터페이스에서 수신 대기하며, 소스 코드는 포트만 넘겨 listen을 호출하는데 Godot에서는 이것이 모든 인터페이스를 의미합니다. 공유 네트워크에서는 실행하지 않는 것이 좋습니다.
어떤 server를 쓰든 저희가 권하는 방법은 다음과 같습니다.
- 세션마다 커밋합니다. 대부분의 server는 에디터의 실행 취소 기록 밖에서 파일을 직접 씁니다.
- 포트는 localhost에 둡니다. 토큰을 지원하는 server를 선호합니다. godot-ai의 인증된 WebSocket이나 Godot-MCP-Native의 선택적 bearer token이 그 예입니다.
- 신뢰할 수 없는 프로젝트나 에셋에 에이전트를 연결하지 않습니다. 씬, 스크립트, README의 텍스트가 모델에 전달됩니다.
- 프로젝트가 내 것이 아니라면 eval 계열 도구는 별도 계정이나 컨테이너에서 실행합니다. tugcantopaloglu의 README에서도 이렇게 권합니다.
작동하지 않을 때
| 보이는 증상 | 서버 | 해결 방법 |
|---|---|---|
| "Godot Not Found" | Coding-Solo | GODOT_PATH를 Godot 실행 파일로 설정합니다. macOS에서는 앱 번들 내부 경로입니다 |
| "Invalid Project Path" | Coding-Solo | project.godot이 들어 있는 폴더를 전달합니다 |
| Windows에서 JSON 파싱 오류 | Coding-Solo | 명령줄 인용 문제로, issues 20과 49에 보고되어 있습니다. 해당 스레드에서 사용 중인 버전을 확인합니다 |
| 플러그인 패널이 없음 | Plugin 서버 | Project Settings, Plugins에서 플러그인을 활성화한 뒤 프로젝트를 다시 로드합니다 |
| 에디터에서 "Disconnected" | Godlink | 다른 프로세스가 6505 포트를 점유하고 있지 않은지 확인하고 클라이언트를 재시작합니다 |
| Windows에서 서버가 시작 직후 종료됨 | godot-ai | Python 의존성 문제입니다(issue 1165). 해당 트러블슈팅 문서를 참고합니다 |
| UID 도구 실패 | Coding-Solo | Godot 4.4 이상이 필요합니다 |
| AI 편집을 실행 취소할 수 없음 | 대부분 | git을 사용하거나 Godlink의 mcp_undo를 사용합니다 |
실제 프로젝트에 신뢰하기 전에 서버를 확인하려면, 여기서 했던 것처럼 MCP Inspector CLI로 도구 목록을 조회하고 위험 없는 도구를 하나 호출해 봅니다. 카탈로그에 있는 Godot 서버와 검사 점수는 이 페이지 상단에 나와 있습니다.