Godot MCP

AI 어시스턴트에게 Godot 에디터에 대한 전체 액세스 권한을 부여하세요.

Claude, Cursor 또는 MCP 호환 AI와 함께 게임을 더 빠르게 제작하세요 — 복사-붙여넣기 없이, 컨텍스트 전환 없이. AI가 여러분의 씬, 스크립트, 노드, 프로젝트 설정을 직접 읽고, 쓰고, 조작합니다.

Godot 4.x · 42가지 도구 · 대화형 프로젝트 시각화 도구 · MIT 라이선스

빠른 시작

0. Node.js 설치 (최초 1회 설정)

nodejs.org (LTS 버전)에서 설치 프로그램을 다운로드하여 실행하세요. 표준 설치 프로그램이므로 터미널이 필요 없습니다.

1. Godot 플러그인 설치

Godot 에디터에서 상단의 AssetLib 탭을 클릭 → "mcp" 를 검색 → "Godot AI Assistant tools MCP" 를 찾아 → 설치(Install)를 클릭하세요.

그런 다음 프로젝트 → 프로젝트 설정 → 플러그인으로 이동하여 Godot MCP 플러그인을 활성화하세요.

2. AI 클라이언트에 서버 구성 추가

Claude Desktop — 설정 → 개발자 → 구성 편집 → 구성 파일을 열고 붙여넣으세요:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — 설정 → MCP → 서버 추가:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — 터미널에서 실행:

claude mcp add godot -- npx -y godot-mcp-server

MCP 호환 클라이언트(Cline, Windsurf 등)와 모두 작동합니다.

3. AI 클라이언트 다시 시작

Claude Desktop / Cursor / 사용 중인 클라이언트를 닫았다가 다시 열어 새 구성을 적용하세요.

4. Godot 프로젝트 다시 시작

Godot 에디터에서 프로젝트 다시 시작을 클릭하세요. 오른쪽 상단을 확인하세요 — MCP 연결됨이 초록색으로 표시될 것입니다. 준비 완료입니다.

Related MCP server: Godot MCP Bridge

무엇을 할 수 있나요?

6개 카테고리, 42개 도구

대화형 시각화 도구

map_project를 실행하면 localhost:6510에서 브라우저 기반 탐색기를 사용할 수 있습니다:

• 모든 스크립트와 그 관계를 보여주는 포스 디렉티드 그래프

• 스크립트를 클릭하면 변수, 함수, 시그널, 연결을 확인할 수 있습니다

• 시각화 도구에서 코드를 직접 편집 — 변경 사항이 Godot에 실시간으로 동기화됩니다

• 노드 속성 편집을 지원하는 씬 뷰

• 리팩터링 전 사용처 찾기

제한 사항

AI는 혼자서 게임의 100%를 만들 수 없습니다 — 복잡한 UI 레이아웃, 씬 합성, 일부 노드 속성 조작에 어려움을 겪습니다. 아직 활발히 개발 중이므로 피드백은 언제나 환영합니다!

아키텍처

┌─────────────┐    MCP (stdio)   ┌──────────────┐   WebSocket   ┌──────────────┐
│  AI Client  │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,   │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)   │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  42 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser    │
                                 │  Visualizer  │
                                 └──────────────┘

현재 제한 사항

• 로컬 전용 — localhost에서 실행, 원격 연결 불가

• 단일 연결 — 한 번에 하나의 Godot 인스턴스만

• 실행 취소 없음 — 변경 사항이 직접 저장됩니다(버전 관리를 사용하세요)

• AI의 Godot 지식은 여전히 제한적 — 혼자서 게임의 100%를 만들 수는 없지만, 디버깅, 스크립트 작성, 그리고 함께하는 과정에 도움이 될 수 있습니다

개발

npm 대신 소스에서 빌드하려면:

cd mcp-server
npm install
npm run build

그런 다음 npx 대신 AI 클라이언트가 mcp-server/dist/index.js를 가리키게 하세요.

릴리스 노트

각 릴리스에 대한 서술형 글은 release-notes/에 있습니다(v0.5.0부터). 전체 변경 내역은 CHANGELOG.md를 참조하세요.

라이선스

MIT

npm 패키지 · 이슈 보고