Bir WebSocket köprüsü aracılığıyla yapay zeka ajanlarının Godot 4 editör oturumlarını ve çalışan oyunları incelemesini ve kontrol etmesini sağlar.
Ayrıca bilinen adı godotbridge/addon, addon
- Yıldızlar
- 5
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.4
- Son commit
- 1 Kas 2026
- Lisans
- MIT
GodotBridge MCP nedir?
GodotBridge bir MCP sunucusudur. Bir WebSocket köprüsü aracılığıyla yapay zeka ajanlarının Godot 4 editör oturumlarını ve çalışan oyunları incelemesini ve kontrol etmesini sağlar.
Özet, projenin README dosyasından oluşturuldu
GodotBridge MCP sunucusu hakkında
GodotBridge, yapay zeka ajanları ile Godot 4 editör oturumları arasında bir bağlantı sağlar. Claude, Cursor veya Windsurf gibi istemcilerin geliştirme ortamınızla etkileşime girmesine olanak tanımak için yerel bir WebSocket köprüsü kullanır. Geliştiriciler, bağlantıyı kurmak için bir GDScript eklentisini doğrudan Godot projelerine yükler ve pip aracılığıyla Python tabanlı bir MCP server çalıştırır. Bu kurulum, bir yapay zekanın hem editörü hem de aktif oyun örneğini aynı anda yönetmesine olanak tanır.
Sistem; sahne oluşturma, animasyon, shader ve fizik gibi görevleri kapsayan, 36 kategoriye ayrılmış 345 araç sunar. Çalışan bir oyunun canlı olarak incelenmesi için ikinci bir kanal oluşturan bir runtime probe içerir. Bu, bir ajanın girdi simüle etmesine, ekran görüntüsü almasına ve hata ayıklama görevlerini gerçekleştirmesine olanak tanır. Eklenti tamamen GDScript ile yazıldığı için derleme gerektirmez ve Godot 4.2 veya üzeri sürümlerle çalışır.
Neler yapabilirsiniz
- 1Otomatik sahne oluşturmaBir yapay zeka ajanı, özel araçları kullanarak Godot editörü içinde sahneler oluşturabilir ve bunları düzenleyebilir.
- 2Canlı oyun hata ayıklamaGeliştiriciler, özel bir runtime kanalı aracılığıyla çalışan bir oyunun durumunu incelemek için yapay zeka kullanabilirler.
- 3Oyuncu etkileşimlerini simüle etmeBir yapay zeka istemcisi, mekanikleri test etmek için çalışan bir oyun oturumu içinde girdileri tetikleyebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
GodotBridge MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleGodotBridge MCP'yi Claude Code içine yükleyin
$ claude mcp add addon -- uvx godotbridgeGodotBridge MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"addon": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"addon","type":"stdio","command":"uvx","args":["godotbridge"]}'GodotBridge MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP'yi Codex içine yükleyin
$ codex mcp add addon -- uvx godotbridgeGodotBridge MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.addon] command = "uvx" args = ["godotbridge"]
GodotBridge MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user addon uvx -- godotbridgeGodotBridge MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirgodotbridge/addon is public and reachablegithub.com/godotbridge/addon ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorgodotbridge names https://github.com/godotbridge/releases/releases as its sourcepypi.org/project/godotbridge/ ↗Bulgu
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-10github.com/godotbridge/addon ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from godotbridgeGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok32 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
GodotBridge MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add addon -- uvx godotbridge komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
GodotBridge MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Sistem gereksinimleri nelerdir?
Godot 4.2 veya üzeri bir sürüme ve Python 3.10 veya üzeri bir sürümde çalışan GodotBridge MCP server yazılımına ihtiyacınız vardır.
Köprü için derleme yapılması gerekiyor mu?
Hayır, eklenti tamamen GDScript ile yazılmıştır ve herhangi bir derleme gerektirmez.