Repolode
Coding-Solo

Coding-Solo/godot-mcp

AI 에이전트가 Godot 에디터를 실행하고 프로젝트를 구동하며, 디버그 출력 캡처와 씬 관리를 할 수 있게 하는 MCP 서버입니다.

스타
6,154
포크
490
열린 이슈
75
마지막 커밋
6개월 전

어떤 프로젝트인가요?

Godot MCP는 AI 에이전트와 Godot 게임 엔진을 연결하는 Model Context Protocol 서버입니다. 에이전트가 프로젝트의 Godot 에디터를 열고, 프로젝트를 디버그 모드로 실행하거나 시작 및 중지하고, 콘솔 출력과 오류 메시지를 읽을 수 있습니다. 이러한 피드백 루프를 통해 에이전트는 Godot 프로젝트에서 실제로 작동하는 부분을 확인하고, 오류를 바탕으로 코드를 수정할 수 있습니다.

프로젝트 실행 외에도 디렉터리의 Godot 프로젝트 목록을 표시하고, 프로젝트 구조와 설치된 Godot 버전을 알려줍니다. 루트 노드 유형을 지정해 씬을 만들고, 사용자 지정 속성을 가진 노드를 추가하고, Sprite2D 노드에 스프라이트와 텍스처를 불러오고, 3D 씬을 GridMap용 MeshLibrary 리소스로 내보내고, 씬을 변형으로 저장할 수도 있습니다. Godot 4.4 이상에서는 파일의 UID를 가져오고 리소스를 다시 저장해 UID 참조를 업데이트할 수 있습니다.

간단한 작업은 Godot의 내장 CLI를 직접 호출하고, 더 복잡한 씬 편집은 JSON 매개변수를 받는 단일 번들 GDScript 파일을 통해 처리합니다. 서버는 Node.js 18 이상에서 실행되며, Claude Code, Cline, Cursor 같은 클라이언트에서 npx 명령 하나로 설정할 수 있습니다.

핵심 기능

  • 01지정한 프로젝트의 Godot 에디터를 실행합니다.
  • 02프로젝트를 디버그 모드로 실행하고 콘솔 출력과 오류를 캡처합니다.
  • 03프로젝트를 프로그래밍 방식으로 시작하고 중지합니다.
  • 04씬을 만들고 사용자 지정 속성을 가진 노드를 추가하며 씬 변형을 저장합니다.
  • 053D 씬을 GridMap용 MeshLibrary 리소스로 내보냅니다.
  • 06Godot 4.4 이상 프로젝트에서 UID를 가져오고 업데이트합니다.

활용 사례

  • AI 코딩 어시스턴트가 Godot 게임을 실행하고 오류를 확인해 테스트하고 디버깅하도록 합니다.
  • AI 에이전트를 통해 Godot 프로젝트의 씬 구조와 노드를 생성합니다.
  • 프로젝트 목록 표시, Godot 버전 확인 등의 프로젝트 설정 작업을 자동화합니다.

빠른 시작

  1. 1

    시스템에 Godot Engine을 설치합니다

  2. 2

    MCP 서버를 Claude Code에 추가합니다

    claude mcp add godot -- npx @coding-solo/godot-mcp
  3. 3

    Godot MCP 도구를 사용하려면 Claude Code를 다시 시작합니다

사용 전 알아둘 점

  • Godot Engine이 로컬에 설치되어 있어야 합니다.
  • UID 관리 기능을 사용하려면 Godot 4.4 이상이 필요합니다.

토픽

자주 묻는 질문

godot-mcp은(는) 무엇인가요?
AI 에이전트가 Godot 에디터를 실행하고 프로젝트를 구동하며, 디버그 출력 캡처와 씬 관리를 할 수 있게 하는 MCP 서버입니다. Godot MCP는 AI 에이전트와 Godot 게임 엔진을 연결하는 Model Context Protocol 서버입니다. 에이전트가 프로젝트의 Godot 에디터를 열고, 프로젝트를 디버그 모드로 실행하거나 시작 및 중지하고, 콘솔 출력과 오류 메시지를 읽을 수 있습니다. 이러한 피드백 루프를 통해 에이전트는 Godot 프로젝트에서 실제로 작동하는 부분을 확인하고, 오류를 바탕으로 코드를 수정할 수 있습니다.
godot-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
godot-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
godot-mcp은(는) 아직 유지보수되고 있나요?
6개월 이상 커밋 없음. godot-mcp의 마지막 커밋은 2026년 4월 16일입니다.
godot-mcp은(는) 어디에 사용할 수 있나요?
AI 코딩 어시스턴트가 Godot 게임을 실행하고 오류를 확인해 테스트하고 디버깅하도록 합니다. AI 에이전트를 통해 Godot 프로젝트의 씬 구조와 노드를 생성합니다. 프로젝트 목록 표시, Godot 버전 확인 등의 프로젝트 설정 작업을 자동화합니다.
godot-mcp는 어떻게 설치하나요?
시스템에 Godot Engine을 설치합니다 MCP 서버를 Claude Code에 추가합니다: claude mcp add godot -- npx @coding-solo/godot-mcp Godot MCP 도구를 사용하려면 Claude Code를 다시 시작합니다
godot-mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Coding-Solo/godot-mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트