{"_id":"@letsagents/godot-mcp","name":"@letsagents/godot-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@letsagents/godot-mcp","version":"1.0.0","description":"MCP server that gives AI clients runtime feedback from Godot (errors / scene tree / node props / screenshot) for an AI self-correction loop.","license":"MIT","author":{"name":"LuoHan"},"repository":{"type":"git","url":"git+https://github.com/letsagents/godot-mcp.git"},"homepage":"https://github.com/letsagents/godot-mcp#readme","bugs":{"url":"https://github.com/letsagents/godot-mcp/issues"},"type":"module","keywords":["godot","mcp","model-context-protocol","ai","claude","game-development","debugging"],"engines":{"node":">=20"},"bin":{"godot-mcp":"server.js"},"scripts":{"start":"tsx server.ts","build":"tsc","serve":"node server.js"},"dependencies":{"@modelcontextprotocol/server":"^2.0.0","zod":"^4.4.3"},"devDependencies":{"@types/node":"^24.13.3","tsx":"^4.23.1","typescript":"^7.0.2"},"_id":"@letsagents/godot-mcp@1.0.0","gitHead":"b96b855cf211e5aa46698fba57c04d95f89ce1f2","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-RfYzH8ZRDuBAtPIyQCqLFPgVVKWqqoIxJ30G/k7acdY6cj3vc5+3jj30Z/PfzflkTS8Wqj/kfTsZE7l9aJq5+Q==","shasum":"e2be32036f0a090beb74f24968ecd1f34ac4803a","tarball":"https://registry.npmjs.org/@letsagents/godot-mcp/-/godot-mcp-1.0.0.tgz","fileCount":5,"unpackedSize":80438,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIE+j8IK6+8DqZ+qZcuax14JviO6q6DS0s6T58eHqJGedAiBjp6qreNJs6zFakPwNOxGKDQNqdlSkXU/1aym/pX4+8Q=="}]},"_npmUser":{"name":"letsagents","email":"519799797@qq.com"},"directories":{},"maintainers":[{"name":"letsagents","email":"519799797@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/godot-mcp_1.0.0_1786402555660_0.7867814030016274"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-10T22:55:55.510Z","1.0.0":"2026-08-10T22:55:55.819Z","modified":"2026-08-10T22:55:56.040Z"},"maintainers":[{"name":"letsagents","email":"519799797@qq.com"}],"description":"MCP server that gives AI clients runtime feedback from Godot (errors / scene tree / node props / screenshot) for an AI self-correction loop.","homepage":"https://github.com/letsagents/godot-mcp#readme","keywords":["godot","mcp","model-context-protocol","ai","claude","game-development","debugging"],"repository":{"type":"git","url":"git+https://github.com/letsagents/godot-mcp.git"},"author":{"name":"LuoHan"},"bugs":{"url":"https://github.com/letsagents/godot-mcp/issues"},"license":"MIT","readme":"# @letsagents/godot-mcp\n\n[English](README.md) | [中文](README_CN.md)\n\n> MCP server that gives AI clients **runtime feedback from Godot** — errors / scene tree / node properties / screenshots — so the AI can self-correct.\n\nThis package is the **server half** of **Godot MCP Bridge**. It bridges any MCP client (Claude Code, Cursor, Cline, Codex CLI, …) to the Godot editor's built-in debug protocol.\n\n> 📦 This is the **server only**. The **Godot editor plugin** is a separate install — see [Prerequisites](#prerequisites).\n>\n> Full docs, tool list, and architecture are in the [main repository](https://github.com/letsagents/godot-mcp).\n\n## Install\n\n```bash\nnpm install -g @letsagents/godot-mcp\n```\n\nRegisters the `godot-mcp` command globally.\n\n## Prerequisites\n\n1. **Node.js ≥ 20** — to run the MCP server (`@modelcontextprotocol/server` v2 requires it).\n2. **Godot editor plugin** — install it in your Godot project first: Godot editor → **AssetLib** → search \"Godot MCP Bridge\" → **Install** (or download the `.zip` from [Releases](https://github.com/letsagents/godot-mcp/releases) and extract into `addons/`). Enable it in **Project Settings → Plugins**.\n3. **Godot editor running** with the plugin enabled. The plugin opens a TCP bridge (default port `6510`) that this server connects to.\n\n## Configure your MCP client\n\nStandard MCP server over stdio. Set `GODOT_MCP_BRIDGE_PORT` to match the plugin's bridge port (default `6510`).\n\n**Claude Code** — project root `.mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"godot-mcp\": { \"command\": \"godot-mcp\", \"env\": { \"GODOT_MCP_BRIDGE_PORT\": \"6510\" } }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`) and **Cline** (`cline_mcp_settings.json`) — identical JSON shape to the above.\n\n**Codex CLI** (`~/.codex/config.toml`, TOML, stdio only):\n```toml\n[mcp_servers.godot-mcp]\ncommand = \"godot-mcp\"\nenv = { GODOT_MCP_BRIDGE_PORT = \"6510\" }\n```\n\n> **Fallback** (can't install globally): set `command` to `\"node\"` and add `\"args\": [\"/abs/path/to/server.js\"]`.\n\n## How it works\n\n```\nMCP client ←stdio→ @letsagents/godot-mcp ←TCP:6510→ [Godot editor] bridge → running game\n```\n\nThe server is a thin translator: MCP (stdio) on one side, a local TCP protocol to the in-editor bridge on the other. The bridge then uses Godot's debug protocol to talk to the running game. Zero intrusion on the user's project (one EditorPlugin, no manual autoload).\n\n## Environment variables\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `GODOT_MCP_BRIDGE_PORT` | `6510` | TCP port the plugin's bridge listens on. Must match on both sides. Set different ports per project (`project.godot → [godot_mcp] bridge_port`) to run multiple editors at once. |\n\n## Tools\n\n**41 tools** — runtime feedback (`get_runtime_errors` / `get_scene_tree` / `inspect_node` / `screenshot` / …), interactive breakpoint debugging, editor-time asset queries, and efficiency controls. Full list + usage: [docs/tools.md](https://github.com/letsagents/godot-mcp/blob/main/docs/tools.md).\n\n## License\n\nMIT © LuoHan\n","readmeFilename":"README.md","_rev":"1-2b5717369be797f80fb52c07d592ec1d"}