AI 기반 Godot 게임 개발을 위한 프리미엄 MCP(모델 컨텍스트 프로토콜) 서버입니다. Claude와 같은 AI 어시스턴트를 Godot 에디터와 직접 연결하며, 187개의 강력한 도구를 제공합니다.

건축

• 실시간: WebSocket 연결은 즉각적인 피드백, 파일 폴링 없음을 의미합니다
• 편집기 통합: Godot 편집기 API, UndoRedo 시스템, 씬 트리에 대한 완전한 접근 권한
• JSON-RPC 2.0: 적절한 오류 코드와 제안이 포함된 표준 프로토콜

이 리포에 뭐가 들어 있을까

⚠️ 이 공개 저장소에는 무료 Godot 애드온/플러그인만 포함되어 있습니다. MCP 서버(Node.js, AI 어시스턴트 연결에 필수)는 유료 패키지의 일부로 배포됩니다 — 일회성 구매, 평생 업데이트:

• 커피 한 잔 사줘:
• itch.io:

유료 zip에는 애드온, 미리 구축된 JavaScript가 포함된 server/ 디렉터리, INSTALL.md, 그리고 AI 클라이언트 명령어가 포함되어 있습니다. 이 저장소를 복제했는데 server/ 폴더가 보이지 않는다면, 그건 예상됩니다 — 위 링크 중 하나에서 전체 패키지를 받아보세요.

퀵 스타트

1. Godot 플러그인 설치

addons/godot_mcp/ 폴더를 Godot 프로젝트의 addons/ 디렉터리에 복사하세요.

Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 187 powerful tools.

Architecture

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

• Real-time: WebSocket connection means instant feedback, no file polling
• Editor Integration: Full access to Godot’s editor API, UndoRedo system, and scene tree
• JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

What’s in this repo

⚠️ This public repo only contains the free Godot addon/plugin. The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package — one-time purchase, lifetime updates:

• Buy Me a Coffee:
• itch.io:

The paid zip includes the addon, the server/ directory with pre-built JavaScript, INSTALL.md, and AI-client instructions. If you cloned this repo and don’t see a server/ folder, that’s expected — grab the full package from one of the links above.

Quick Start

1. Install the Godot Plugin

Copy the addons/godot_mcp/ folder into your Godot project’s addons/ directory.

Enable the plugin: Project → Project Settings → Plugins → Godot MCP Pro → Enable

2. Install the MCP Server

The server/ directory is only included in the full paid package (see above). After downloading and extracting the zip, run:

cd server
npm install
npm run build

3. Configure Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4. Choose Your Mode

Godot MCP Pro offers four modes to fit any client’s tool limit:

--3d includes the core tools plus physics, AnimationTree and navigation, but omits uid_to_project_path, project_path_to_uid, compare_screenshots, clear_output, close_script, reload_open_scripts, set_anchor_preset and click_button_by_text to stay within the 100-tool cap.

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

Replace --lite with --minimal for the smallest footprint.

• Lite includes: project, scene, node, script, editor, input, runtime, and input_map tools.