Skip to main content
Glama

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 프로젝트에서 무엇이 작동하고 무엇이 작동하지 않는지 이해하도록 도와주어, 더 나은 코드 생성 및 디버깅 지원을 가능하게 합니다.

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-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 사용:

  1. Cursor 설정 > 기능(Features) > MCP로 이동

  2. + Add New MCP Server 버튼 클릭

  3. 양식 작성:

    • 이름: godot

    • 유형: command

    • 명령어: npx @coding-solo/godot-mcp

  4. "Add" 클릭

  5. 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 방식을 사용합니다:

  1. 직접 명령어: 에디터 실행이나 프로젝트 정보 가져오기와 같은 간단한 작업은 Godot의 내장 CLI 명령어를 직접 사용합니다.

  2. 번들 작업 스크립트: 씬 생성이나 노드 추가와 같은 복잡한 작업은 모든 작업을 처리하는 단일 포괄적 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 tools
add_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

    B3.4/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      44
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      33
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      16
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An 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.
      25
      30 npm
      MIT