godot-mcp

🇫🇷 Français · 🇬🇧 English

godot-mcp

Pont MCP entre un assistant IA et l'éditeur Godot.

Assistant IA <---stdio/MCP---> godot-mcp <---WebSocket:6505---> Plugin Godot

6 outils MCP pour piloter l'éditeur : godot_call (175+ méthodes), godot_list_methods, godot_info, godot_screenshot, godot_execute, godot_status.

Installation

1. Plugin Godot

Copiez le dossier plugin/ dans addons/godot_mcp/ de votre projet Godot.

votre-projet/
└── addons/
    └── godot_mcp/       ← copiez plugin/ ici

Activez-le : Projet → Paramètres du projet → Plugins → godot-mcp → Activer

2. Serveur

npm install && npm run build && npm start

3. Client MCP

Ajoutez à la config de votre client IA (.mcp.json, claude.json, opencode.json) :

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": ["/chemin/vers/godot-mcp/dist/index.js"]
    }
  }
}

Outils

Chemins de nodes : les paramètres parent_path et node_path degodot_call (ex. add_node, update_property, delete_node) sonttoujours relatifs à la racine de la scène actuellement éditée ("." =racine de la scène). Les chemins absolus Godot ("/root", "../...") sontrejetés — ils cibleraient l'arbre interne de l'éditeur au lieu de la scène.

godot_screenshot nécessite un éditeur avec rendu actif : il nefonctionne pas en mode --headless (erreur "Could not get image fromviewport").

Arborescence

godot-mcp/
├── plugin/              ← Plugin Godot (à copier dans votre projet)
├── src/index.ts         ← Serveur MCP (Node.js)
├── package.json
├── tsconfig.json
├── README.md
└── LICENSE              ← MIT

Licence

MIT

Ce plugin Godot dérive de godot-mcp-pro (Youichi Uda, MIT).

godot-mcp

MCP bridge between an AI assistant and the Godot editor.

AI Assistant <---stdio/MCP---> godot-mcp <---WebSocket:6505---> Godot Plugin

6 MCP tools to control the editor: godot_call (175+ methods), godot_list_methods, godot_info, godot_screenshot, godot_execute, godot_status.

Setup

1. Godot Plugin

Copy the plugin/ folder into your project's addons/godot_mcp/.

your-project/
└── addons/
    └── godot_mcp/       ← copy plugin/ here

Enable it: Project → Project Settings → Plugins → godot-mcp → Enable

2. Server

npm install && npm run build && npm start

3. MCP Client

Add to your AI client config (.mcp.json, claude.json, opencode.json):

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

Tools

Node paths: parent_path and node_path parameters of godot_call(e.g. add_node, update_property, delete_node) are always relative tothe root of the currently edited scene ("." = scene root). AbsoluteGodot paths ("/root", "../...") are rejected — they would target theeditor's internal tree instead of the scene.

godot_screenshot requires an editor with active rendering: it does notwork in --headless mode ("Could not get image from viewport" error).

Structure

godot-mcp/
├── plugin/              ← Godot plugin (copy to your project)
├── src/index.ts         ← MCP server (Node.js)
├── package.json
├── tsconfig.json
├── README.md
└── LICENSE              ← MIT

License

MIT

This Godot plugin is derived from godot-mcp-pro (Youichi Uda, MIT).