Godot mcp

Published at 2025-07-25

TIL - Godot mcp

날짜: 2025년 7월 25일

godot 게임 개발을 하면서 cursor로 코드 작성에 도움을 받고 있었는데, cursor만으로는 실행을 시켜볼 수 없어서 의도대로 구현이 안되었어도 직접 테스트를 해본 뒤 이러이러한 기능이 안된다고 다시 cursor에 알려줘서 수정해야했다.

최근에 gemini cli 도구를 추가한 김에 gemini cli에 사용할 수 있는 godot mcp server를 사용해보기로 했다.

godot mcp 문서

적용 방법

  1. mcp 저장소 복제 & 빌드
git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
yarn install
yarn run build

문서에서는 npm으로 설치&빌드로 안내되어있었는데 나는 yarn을 사용했다.

  1. 설정파일에 추가
{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["1에서 빌드한 index.js파일 경로"],
      "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"
      ]
    }
  }
}

gemini cli 도구를 실행해보면 mcp 목록에 godot가 추가되어있다. (ctrl + t)

image.png