{"id":18393,"library":"godot-mcp-server","title":"Godot MCP Server","description":"MCP server for Godot game engine integration, enabling AI assistants like Claude and Cursor to manipulate Godot scenes, scripts, nodes, and project settings in real time. Current stable version 0.5.0, released March 2025, with monthly updates. Provides 32 tools across 6 categories (file, scene, script, project operations, asset generation, visualization) plus an interactive web-based project map. Unlike generic file-editing MCP servers, it communicates via WebSocket with the Godot editor plugin for live project state access, allowing direct editing of runtime properties and node trees without file system guesswork. TypeScript-first with full ESM support, designed for Godot 4.x.","status":"active","version":"0.5.0","language":"javascript","source_language":"en","source_url":"https://github.com/tomyud1/godot-mcp","tags":["javascript","mcp","godot","game-development","ai-assistant","typescript"],"install":[{"cmd":"npm install godot-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add godot-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add godot-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"MCP protocol implementation","package":"@modelcontextprotocol/sdk","optional":false}],"imports":[{"note":"Package exports a main() function; there is no default export. Also, the primary use is CLI via npx, not programmatic import.","wrong":"const GodotMCP = require('godot-mcp-server')","symbol":"main","correct":"import { main } from 'godot-mcp-server'"},{"note":"Internal class, not directly exported from root. Use only if extending the server.","wrong":"import GodotMCPServer from 'godot-mcp-server'","symbol":"GodotMCPServer","correct":"import { GodotMCPServer } from 'godot-mcp-server/lib/server'"},{"note":"Tool registry is a separate export; check lib/tools for available tool classes.","wrong":"import { Tools } from 'godot-mcp-server'","symbol":"ToolRegistry","correct":"import { ToolRegistry } from 'godot-mcp-server/lib/tools'"}],"quickstart":{"code":"{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"godot-mcp-server\"]\n    }\n  }\n}","lang":"json","description":"Configuration for Claude Desktop or Cursor to enable godot-mcp-server. Copy this JSON into the MCP settings file."},"warnings":[{"fix":"Update calls to include full absolute path for parent_path.","message":"From v0.5.0, the 'scene_add_node' tool changed signature: 'parent_path' is now required and must be a full node path (e.g., /root/Main/Player) instead of relative.","severity":"breaking","affected_versions":">=0.5.0"},{"fix":"Replace get_scene_tree with dump_scene.","message":"The 'get_scene_tree' tool is deprecated in v0.5.0, replaced by 'dump_scene' which provides richer node property data.","severity":"deprecated","affected_versions":">=0.5.0"},{"fix":"Ensure the Godot MCP plugin is enabled in Project Settings > Plugins and Godot is running.","message":"The Godot plugin must be running and connected on WebSocket port 6505. If the plugin is not enabled, the server will start but tools will fail with 'Plugin not connected'.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Run the AI client and Godot on the same machine.","message":"The server only works locally (localhost). It does not support remote connections; attempting to connect from another machine will silently fail.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npx -y godot-mcp-server' with the -y flag to auto-install.","cause":"npx cache or global install missing","error":"Error: Cannot find module 'godot-mcp-server'"},{"fix":"Start Godot with project loaded and ensure Godot MCP plugin is enabled (Project > Project Settings > Plugins).","cause":"Godot editor not running or plugin not enabled","error":"MCP server disconnected: WebSocket connection failed"},{"fix":"Provide full absolute node path, e.g., 'parent_path': '/root/Main'.","cause":"Missing or malformed parent_path argument in scene tool","error":"Tool execution error: parent_path is required"},{"fix":"Only access files within the opened Godot project folder.","cause":"Attempted to read/write a file outside the project directory","error":"Forbidden path traversal detected"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}