godot-hands
Donnez les mains à votre assistant IA sur l'éditeur Godot — avec 10 outils au lieu de 100.
Assistant IA <---stdio/MCP---> godot-hands <---WebSocket:6505---> Plugin Godot
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add godot-hands -- npx -y godot-hands@1.0.0รันในเทอร์มินัล
{ "mcpServers": { "godot-hands": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Donnez les mains à votre assistant IA sur l'éditeur Godot — avec 10 outils au lieu de 100.
Assistant IA <---stdio/MCP---> godot-hands <---WebSocket:6505---> Plugin Godot
Give your AI assistant hands on the Godot editor — 10 MCP tools, a live catalog of 210 addon methods, zero tool-spray
La plupart des serveurs MCP Godot exposent chaque méthode de l'addon comme un tool MCP séparé — 50, 80, parfois plus de 100 entrées dans le catalogue que le modèle doit lire et trier avant chaque appel. Plus la surface est large, moins un LLM choisit le bon outil de façon fiable, et plus chaque requête coûte cher en tokens rien que pour décrire les outils disponibles.
godot-hands prend le pari inverse : 10 outils, dont un seul (godot_call)
donne accès à un catalogue de 210 méthodes réparties en ~25 catégories
(scène, nodes, 3D, physique, animation, shaders, tilemap, particules, audio,
navigation, export Android, tests…), découvert en direct auprès de
l'éditeur connecté plutôt que figé dans ce dépôt. Le modèle demande le
schéma dont il a besoin (godot_describe) au lieu de tout charger d'un
coup. Résultat mesuré (npm run token-cost) : ~1460 tokens pour toute
la surface d'outils.
Le reste tient en une phrase : zéro dépendance runtime en dehors du SDK MCP, aucun service externe, le plugin Godot est un simple client WebSocket — vous savez exactement ce qui tourne et où.
confirm: true ; les éditions de script portent un garde optimiste par
SHA-256 pour ne pas écraser silencieusement un changement fait entre-temps
dans l'éditeur ; les mutations de scène passent par
EditorUndoRedoManager — un Ctrl-Z suffit toujours à annuler.godot_status {"select": "..."} épingle celui qui doit recevoir
les appels au lieu de tomber sur le premier connecté par hasard.godot_call {"async": true}
rend la main immédiatement avec un job_id à relire via godot_job —
un stress test de 60s ne meurt plus au bout de 30.debug_data du debugger Godot.step_frames) ou jusqu'à
condition (wait_for_condition) — pour reproduire un bug plutôt que le
chasser à l'aveugle.Deux commandes, zéro build, pas de clone de dépôt :
# 1. Pose l'addon Godot dans votre projet (addons/godot_mcp/)
npx godot-hands install ./mon-jeu
Activez-le : Projet → Paramètres du projet → Plugins → godot-hands → Activer
{
"mcpServers": {
"godot-hands": {
"command": "npx",
"args": ["-y", "godot-hands"]
}
}
}
Préférez installer une bonne fois pour toutes ? npm install -g godot-hands,
puis "command": "godot-hands" dans la config. Le paquet npm embarque le
plugin Godot : la sous-commande install le copie depuis node_modules
(ou copiez manuellement node_modules/godot-hands/plugin/ vers
addons/godot_mcp/, c'est équivalent).
Confirmation obligatoire (
confirm: true) : les méthodes qui écrivent ou suppriment un fichier sur disque, modifientproject.godot, ou exécutent du code arbitraire dans le process éditeur/jeu (create_scene,delete_scene,edit_script,execute_editor_script,set_project_setting, etc.) refusent l'appel avec l'erreur-32009tant queparams.confirmn'est pastrue.godot_describeliste ce paramètre dans le schéma de chaque méthode concernée. Les mutations de la scène éditée (ajout/suppression de nodes, changement de propriétés, CSG, scatter…) ne sont pas gatées : elles passent parEditorUndoRedoManageret un simple Ctrl-Z suffit à les annuler.
godot_assetseffectue des requêtes réseau sortantes verspolyhaven.cometambientcg.com.importécrit les fichiers dans<projet>/assets/<provider>/<id>/(chemin obtenu viaget_project_info) puis déclenche un rescan du projet. Sources CC0 uniquement (domaine public, aucune attribution légalement requise) ; une noteNOTICE.txtest écrite à côté de chaque asset importé.
Chemins de nodes : les paramètres
parent_pathetnode_pathdegodot_call(ex.add_node,update_property,delete_node) sont toujours relatifs à la racine de la scène actuellement éditée ("."= racine de la scène). Les chemins absolus Godot ("/root","../...") sont rejetés — ils cibleraient l'arbre interne de l'éditeur au lieu de la scène.Handles de session : tout paramètre
node_pathaccepte aussi un handle (chaîne"@id:<n>", renvoyée sous"handle"parget_scene_tree,add_node,rename_node, etc.) à la place d'un chemin. Un handle continue de désigner le même node après un renommage ou un déplacement dans la scène, contrairement à un chemin qui casse dès que l'un des deux se produit — utile pour enchaîner plusieurs appels sur le node qu'on vient de créer/modifier. Un handle expire si la scène est rechargée/refermée ; rappelezget_scene_treepour en obtenir un nouveau.
godot_screenshotnécessite un éditeur avec rendu actif : il ne fonctionne pas en mode--headless(erreur "Could not get image from viewport").
En plus des outils, le serveur expose l'état du projet en ressources
(gratuites en tokens tant qu'elles ne sont pas lues, contrairement aux
outils) : godot://scene/current, godot://project/info,
godot://project/settings, godot://logs/recent, et le template
godot://class/{name} (réflexion ClassDB, mise en cache 5 min — les classes
du moteur ne changent pas en cours de session).
Quatre prompts réutilisables guident les workflows pour lesquels ce
serveur a été conçu : blockout-3d-level, diagnose-crash,
audit-scene-perf, asset-strategy.
godot_assets {action: "import"} envoie des notifications de progression
(notifications/progress) si le client fournit un progressToken — le
téléchargement peut prendre du temps sur une connexion lente.
godot-hands/
├── plugin/ ← Plugin Godot (embarqué dans le paquet npm)
├── src/index.ts ← Serveur MCP (Node.js)
├── src/assets/ ← Sourcing d'assets CC0 (Poly Haven, ambientCG)
├── package.json
├── tsconfig.json
├── README.md
└── LICENSE ← MIT
npm test # tests unitaires (vitest), y compris le contract-check addon/serveur
npm run contract # contract-check seul : get_commands()/get_command_schemas() alignés, modules enregistrés
npm run test:godot # tests GDScript en --headless (nécessite `godot`/`godot4` sur le PATH ou GODOT_BIN)
npm run token-cost # mesure le poids en tokens de la surface d'outils (et le contrefactuel si un éditeur est connecté)
MIT
Give your AI assistant real control of the Godot editor — with 10 tools instead of 100.
AI Assistant <---stdio/MCP---> godot-hands <---WebSocket:6505---> Godot Plugin
Most Godot MCP servers expose every addon method as its own MCP tool — 50, 80, sometimes 100+ entries the model has to read and sort through before every single call. The bigger that surface gets, the less reliably an LLM picks the right tool, and the more tokens get burned on tool descriptions before the conversation even starts.
godot-hands takes the opposite bet: 10 tools, one of which (godot_call)
opens onto a catalog of 210 methods across ~25 categories (scene,
nodes, 3D, physics, animation, shaders, tilemaps, particles, audio,
navigation, Android export, testing…), discovered live from the
connected editor instead of hardcoded in this repo. The model asks for the
schema it actually needs (godot_describe) instead of loading everything
up front. Measured result (npm run token-cost): ~1460 tokens for the
whole tool surface.
Everything else fits in one sentence: zero runtime dependencies beyond the MCP SDK, no external services, the Godot plugin is a plain WebSocket client — you know exactly what's running and where.
confirm: true;
script edits carry an optimistic SHA-256 guard so they can't silently
clobber a change made in the editor in the meantime; scene mutations go
through EditorUndoRedoManager — a plain Ctrl-Z always undoes them.godot_status {"select": "..."} pins which one receives calls
instead of falling back to whichever connected first.godot_call {"async": true} returns
a job_id immediately, polled via godot_job — a 60-second stress test
no longer dies at the 30-second mark.debug_data signal.step_frames) or stepping
until a condition holds (wait_for_condition) — reproduce a bug instead
of hunting it blind.Two commands, zero build, no repo clone:
# 1. Drops the Godot addon into your project (addons/godot_mcp/)
npx godot-hands install ./my-game
Enable it: Project → Project Settings → Plugins → godot-hands → Enable
{
"mcpServers": {
"godot-hands": {
"command": "npx",
"args": ["-y", "godot-hands"]
}
}
}
Prefer a permanent install? npm install -g godot-hands, then use
"command": "godot-hands" in the config. The npm package ships the Godot
plugin itself: the install subcommand copies it out of node_modules
(or manually copy node_modules/godot-hands/plugin/ to addons/godot_mcp/
— same thing).
Confirmation required (
confirm: true): methods that write to or delete a file on disk, modifyproject.godot, or run arbitrary code in the editor/game process (create_scene,delete_scene,edit_script,execute_editor_script,set_project_setting, etc.) refuse the call with a-32009error untilparams.confirmistrue.godot_describelists this parameter in the schema of every gated method. Mutations to the edited scene (adding/removing nodes, property changes, CSG, scatter…) are not gated: they go throughEditorUndoRedoManager, so a plain Ctrl-Z undoes them.
godot_assetsmakes outbound network requests topolyhaven.comandambientcg.com.importwrites files under<project>/assets/<provider>/<id>/(path learned viaget_project_info) and then triggers a project rescan. CC0 sources only (public domain, no attribution legally required); aNOTICE.txtis written next to each imported asset regardless.
Node paths:
parent_pathandnode_pathparameters ofgodot_call(e.g.add_node,update_property,delete_node) are always relative to the root of the currently edited scene ("."= scene root). Absolute Godot paths ("/root","../...") are rejected — they would target the editor's internal tree instead of the scene.Session handles: any
node_pathparameter also accepts a handle (an"@id:<n>"string, returned as"handle"byget_scene_tree,add_node,rename_node, etc.) instead of a path. A handle keeps addressing the same node across a rename or reparent, where a path would break — useful for chaining several calls against the node you just created/modified. A handle goes stale when the scene is reloaded/reopened; callget_scene_treeagain for a fresh one.
godot_screenshotrequires an editor with active rendering: it does not work in--headlessmode ("Could not get image from viewport" error).
Besides tools, the server exposes project state as resources (free in
tokens until actually read, unlike tools): godot://scene/current,
godot://project/info, godot://project/settings, godot://logs/recent,
and the template godot://class/{name} (ClassDB reflection, cached for 5
minutes — engine classes don't change mid-session).
Four reusable prompts guide the workflows this server was built for:
blockout-3d-level, diagnose-crash, audit-scene-perf, asset-strategy.
godot_assets {action: "import"} sends notifications/progress updates if
the client supplies a progressToken — the download can take a while on a
slow connection.
npm test # unit tests (vitest), including the addon/server contract-check
npm run contract # contract-check alone: get_commands()/get_command_schemas() agree, every module registered
npm run test:godot # headless GDScript tests (needs `godot`/`godot4` on PATH or GODOT_BIN)
npm run token-cost # measures the tool surface's token weight (and the counterfactual if an editor is connected)
godot-hands/
├── plugin/ ← Godot plugin (bundled in the npm package)
├── src/index.ts ← MCP server (Node.js)
├── src/assets/ ← CC0 asset sourcing (Poly Haven, ambientCG)
├── test/ ← vitest suite + headless GDScript fixture project
├── package.json
├── tsconfig.json
├── README.md
└── LICENSE ← MIT
MIT
Give your AI assistant hands on the Godot editor — 10 MCP tools, a live catalog of 210 addon methods, zero tool-spray
{ "mcpServers": { "godot-hands": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Godot Hands ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-16 Give your AI assistant hands on the Godot editor — 10 MCP tools, a live catalog of 210 addon methods, zero tool-spray