WebSocket 브릿지를 통해 AI agent가 Godot 4 에디터 세션과 실행 중인 게임을 검사하고 제어할 수 있도록 합니다.
다른 이름 godotbridge/addon, addon
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.4
- 마지막 커밋
- 2026년 11월 1일
- 라이선스
- MIT
GodotBridge MCP란?
GodotBridge은(는) MCP server입니다. WebSocket 브릿지를 통해 AI agent가 Godot 4 에디터 세션과 실행 중인 게임을 검사하고 제어할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
GodotBridge MCP server 정보
GodotBridge는 AI agent와 Godot 4 에디터 세션 간의 연결을 제공합니다. 로컬 WebSocket 브릿지를 사용하여 Claude, Cursor 또는 Windsurf와 같은 클라이언트가 개발 환경과 상호작용할 수 있도록 합니다. 개발자는 GDScript 플러그인을 Godot 프로젝트에 직접 설치하고, pip를 통해 Python 기반 MCP server를 실행하여 연결을 설정합니다. 이 설정을 통해 AI는 에디터와 활성화된 게임 인스턴스를 동시에 관리할 수 있습니다.
이 시스템은 씬 구축, 애니메이션, 셰이더, 물리 등의 작업을 포함하여 36개 카테고리로 분류된 345개의 도구를 제공합니다. 실행 중인 게임을 실시간으로 검사할 수 있는 두 번째 채널을 생성하는 런타임 프로브가 포함되어 있습니다. 이를 통해 agent는 입력을 시뮬레이션하고, 스크린샷을 찍으며, 디버깅 작업을 수행할 수 있습니다. 플러그인이 순수 GDScript로 작성되었기 때문에 컴파일이 필요 없으며 Godot 4.2 이상 버전에서 작동합니다.
활용 사례
- 1자동 씬 구축AI agent가 특화된 도구를 사용하여 Godot 에디터 내에서 씬을 구축하고 구성할 수 있습니다.
- 2실시간 게임 디버깅개발자는 전용 런타임 채널을 통해 실행 중인 게임의 상태를 검사하는 데 AI를 사용할 수 있습니다.
- 3플레이어 상호작용 시뮬레이션AI 클라이언트가 실행 중인 게임 세션 내에서 입력을 트리거하여 메커니즘을 테스트할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
GodotBridge MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 GodotBridge MCP 설치
$ claude mcp add addon -- uvx godotbridgeCursor에 GodotBridge MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}VS Code에 GodotBridge MCP 설치
.vscode/mcp.json
{
"servers": {
"addon": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}VS Code CLI에 GodotBridge MCP 설치
$ code --add-mcp '{"name":"addon","type":"stdio","command":"uvx","args":["godotbridge"]}'Claude Desktop에 GodotBridge MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Codex에 GodotBridge MCP 설치
$ codex mcp add addon -- uvx godotbridgeCodex config.toml에 GodotBridge MCP 설치
~/.codex/config.toml
[mcp_servers.addon] command = "uvx" args = ["godotbridge"]
Gemini CLI에 GodotBridge MCP 설치
$ gemini mcp add -s user addon uvx -- godotbridgeGemini settings.json에 GodotBridge MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능godotbridge/addon is public and reachablegithub.com/godotbridge/addon ↗통과
- 패키지가 이 저장소를 소스로 명시godotbridge names https://github.com/godotbridge/releases/releases as its sourcepypi.org/project/godotbridge/ ↗결함 발견
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-10github.com/godotbridge/addon ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from godotbridge통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음32 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기GodotBridge — Godot Editor Plugin
The Godot 4.x editor addon for GodotBridge. This plugin creates a local WebSocket bridge that lets an MCP-speaking AI agent (Claude, Cursor, Windsurf, or any MCP client) inspect and control your Godot editor session and running game.
Features
- 345 tools across 36 categories — scene building, animation, shaders, physics, runtime game control, AI Image Studio, and more
- Real-time bridge — WebSocket connection between the editor and the MCP server
- Runtime probe — a second channel to the running game for live inspection, input simulation, screenshots, and debugging
- Zero compilation — pure GDScript, drop-in plugin
Installation
From Godot Asset Library (recommended)
- Open your Godot project
- Go to AssetLib tab
- Search for GodotBridge
- Click Download → Install
- Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Manual installation
- Download or clone this repository
- Copy the
addons/godot_mcp_bridgefolder into your Godot project'saddons/directory - Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Setup
This plugin is the editor-side half of GodotBridge. You also need the MCP server to connect your AI agent:
pip install godotbridge
Then register it with your AI client:
Claude Code:
claude mcp add godot-bridge -- godotbridge
Claude Desktop / Cursor / Windsurf:
Add to your MCP config:
{
"mcpServers": {
"godot-bridge": {
"command": "godotbridge"
}
}
}
For detailed setup instructions, visit godotbridge.com.
How it works
Your AI agent (Claude, Cursor, etc.)
│
│ MCP / stdio
▼
GodotBridge MCP Server (Python)
│
│ WebSocket · ws://127.0.0.1:8765
▼
This plugin (Godot editor)
│
│ WebSocket · ws://127.0.0.1:8766
▼
Your running game (runtime probe)
The editor plugin hosts the WebSocket server. The MCP server connects to it as a client — so the bridge survives your AI session ending and reconnects automatically.
Requirements
- Godot 4.2 or later
- GodotBridge MCP server (Python 3.10+)
License
MIT — see LICENSE for details.
Links
GodotBridge MCP 질문
GodotBridge MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add addon -- uvx godotbridge를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
GodotBridge MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
시스템 요구 사항은 무엇인가요?
Godot 4.2 이상 버전과 Python 3.10 이상에서 실행되는 GodotBridge MCP server가 필요합니다.
브릿지를 사용하려면 컴파일이 필요한가요?
아니요, 플러그인은 순수 GDScript로 작성되어 컴파일이 전혀 필요하지 않습니다.