Godot MCP

**Coding-Solo/godot-mcp**의 커밋 1209744(MIT)에서 포크되었습니다. 이 포크는 @jamesdowzard가 독립적으로 유지 관리하며, Android 내보내기 검증기 지원 및 기타 AI 친화적인 도구를 추가했습니다. 업스트림 포크 관계는 git 수준에서 단절되었으며, 저작권/귀속은 MIT 라이선스에 따라 보존됩니다.

Made with Godot

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Godot 게임 엔진과 상호작용하기 위한 MCP(Model Context Protocol) 서버입니다.

소개

Godot MCP를 사용하면 AI 에이전트가 Godot 에디터를 실행하고, 프로젝트를 구동하며, 디버그 출력을 캡처하고, 프로젝트 실행을 제어할 수 있습니다. 이러한 직접적인 피드백 루프는 에이전트가 실제 Godot 프로젝트에서 무엇이 작동하고 무엇이 작동하지 않는지 이해하도록 도와주어, 더 나은 코드 생성 및 디버깅 지원을 가능하게 합니다.

주요 기능

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-mcp

Cline 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_PATH`	Godot 실행 파일 경로 (자동 감지보다 우선함)
`DEBUG`	상세 서버 측 디버그 로깅을 활성화하려면 `"true"`로 설정

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 파일을 참조하세요.

Godot MCP

Godot MCP

소개

주요 기능

요구 사항

빠른 시작

Claude Code

환경 변수

아키텍처

문제 해결

라이선스

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API