[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72681":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":16,"starSnapshotCount":16,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},72681,"godot-mcp","Coding-Solo\u002Fgodot-mcp","Coding-Solo","MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.","",null,"JavaScript",4106,389,32,27,0,62,166,506,186,109.77,"MIT License",false,"main",[26,27,28],"ai","godot","mcp","2026-06-12 04:01:06","# Godot MCP\n\n[![Github-sponsors](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fsponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=#EA4AAA)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002FCoding-Solo)\n\n[![](https:\u002F\u002Fbadge.mcpx.dev?type=server 'MCP Server')](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction)\n[![Made with Godot](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMade%20with-Godot-478CBF?style=flat&logo=godot%20engine&logoColor=white)](https:\u002F\u002Fgodotengine.org)\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-339933?style=flat&logo=nodedotjs&logoColor=white 'Node.js')](https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload\u002F)\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-3178C6?style=flat&logo=typescript&logoColor=white 'TypeScript')](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FCoding-Solo\u002Fgodot-mcp 'Last Commit')](https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fcommits\u002Fmain)\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FCoding-Solo\u002Fgodot-mcp 'Stars')](https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fstargazers)\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FCoding-Solo\u002Fgodot-mcp 'Forks')](https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fnetwork\u002Fmembers)\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-red.svg 'MIT License')](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n\n```text\n                           (((((((             (((((((\n                        (((((((((((           (((((((((((\n                        (((((((((((((       (((((((((((((\n                        (((((((((((((((((((((((((((((((((\n                        (((((((((((((((((((((((((((((((((\n         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((\n       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((\n         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((\n         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((\n         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((\n         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((\n         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((\n         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@\n         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((\n         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((\n          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((\n           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((\n              (((((((((((((((((((((((((((((((((((((((((((((((((((((\n                 (((((((((((((((((((((((((((((((((((((((((((((((\n                        (((((((((((((((((((((((((((((((((\n\n\n                          \u002F$$      \u002F$$  \u002F$$$$$$  \u002F$$$$$$$\n                         | $$$    \u002F$$$ \u002F$$__  $$| $$__  $$\n                         | $$$$  \u002F$$$$| $$  \\__\u002F| $$  \\ $$\n                         | $$ $$\u002F$$ $$| $$      | $$$$$$$\u002F\n                         | $$  $$$| $$| $$      | $$____\u002F\n                         | $$\\  $ | $$| $$    $$| $$\n                         | $$ \\\u002F  | $$|  $$$$$$\u002F| $$\n                         |__\u002F     |__\u002F \\______\u002F |__\u002F\n```\n\nA Model Context Protocol (MCP) server for interacting with the Godot game engine.\n\n## Introduction\n\nGodot MCP enables AI agents to launch the Godot editor, run projects, capture debug output, and control project execution. This direct feedback loop helps agents understand what works and what doesn't in real Godot projects, leading to better code generation and debugging assistance.\n\n## Features\n\n- **Launch Godot Editor**: Open the Godot editor for a specific project\n- **Run Godot Projects**: Execute Godot projects in debug mode\n- **Capture Debug Output**: Retrieve console output and error messages\n- **Control Execution**: Start and stop Godot projects programmatically\n- **Get Godot Version**: Retrieve the installed Godot version\n- **List Godot Projects**: Find Godot projects in a specified directory\n- **Project Analysis**: Get detailed information about project structure\n- **Scene Management**:\n  - Create new scenes with specified root node types\n  - Add nodes to existing scenes with customizable properties\n  - Load sprites and textures into Sprite2D nodes\n  - Export 3D scenes as MeshLibrary resources for GridMap\n  - Save scenes with options for creating variants\n- **UID Management** (for Godot 4.4+):\n  - Get UID for specific files\n  - Update UID references by resaving resources\n\n## Requirements\n\n- [Godot Engine](https:\u002F\u002Fgodotengine.org\u002Fdownload) installed on your system\n- Node.js (>=18.0.0) and npm\n- An AI agent that supports MCP\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add godot -- npx @coding-solo\u002Fgodot-mcp\n```\n\nThat's it. Restart Claude Code and your Godot MCP tools are available.\n\nWith environment variables:\n\n```bash\nclaude mcp add godot -e GODOT_PATH=\u002Fpath\u002Fto\u002Fgodot -e DEBUG=true -- npx @coding-solo\u002Fgodot-mcp\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cline\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAdd to your Cline MCP settings file (`~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coding-solo\u002Fgodot-mcp\"],\n      \"env\": {\n        \"DEBUG\": \"true\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": [\n        \"launch_editor\",\n        \"run_project\",\n        \"get_debug_output\",\n        \"stop_project\",\n        \"get_godot_version\",\n        \"list_projects\",\n        \"get_project_info\",\n        \"create_scene\",\n        \"add_node\",\n        \"load_sprite\",\n        \"export_mesh_library\",\n        \"save_scene\",\n        \"get_uid\",\n        \"update_project_uids\"\n      ]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n**Using the Cursor UI:**\n\n1. Go to **Cursor Settings** > **Features** > **MCP**\n2. Click on the **+ Add New MCP Server** button\n3. Fill out the form:\n   - Name: `godot`\n   - Type: `command`\n   - Command: `npx @coding-solo\u002Fgodot-mcp`\n4. Click \"Add\"\n5. You may need to press the refresh button in the top right corner of the MCP server card to populate the tool list\n\n**Using Project-Specific Configuration:**\n\nCreate a file at `.cursor\u002Fmcp.json` in your project directory:\n\n```json\n{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coding-solo\u002Fgodot-mcp\"],\n      \"env\": {\n        \"DEBUG\": \"true\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Other MCP Clients\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nFor any MCP-compatible client, use this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coding-solo\u002Fgodot-mcp\"],\n      \"env\": {\n        \"GODOT_PATH\": \"\u002Fpath\u002Fto\u002Fgodot\",\n        \"DEBUG\": \"true\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n### Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `GODOT_PATH` | Path to the Godot executable (overrides automatic detection) |\n| `DEBUG` | Set to `\"true\"` to enable detailed server-side debug logging |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Building from Source\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp.git\ncd godot-mcp\nnpm install\nnpm run build\n```\n\nThen point your MCP client to `build\u002Findex.js` instead of using `npx`.\n\n\u003C\u002Fdetails>\n\n\n## Architecture\n\nThe Godot MCP server uses a bundled GDScript approach for complex operations:\n\n1. **Direct Commands**: Simple operations like launching the editor or getting project info use Godot's built-in CLI commands directly.\n2. **Bundled Operations Script**: Complex operations like creating scenes or adding nodes use a single, comprehensive GDScript file (`godot_operations.gd`) that handles all operations.\n\nThe bundled script accepts operation type and parameters as JSON, allowing for flexible and dynamic operation execution without generating temporary files for each operation.\n\n## Troubleshooting\n\n- **Godot Not Found**: Set the `GODOT_PATH` environment variable to your Godot executable path\n- **Connection Issues**: Ensure the server is running and restart your AI assistant\n- **Invalid Project Path**: Ensure the path points to a directory containing a `project.godot` file\n- **Build Issues**: Make sure all dependencies are installed by running `npm install`\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor-Specific Issues\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- Ensure the MCP server shows up and is enabled in Cursor settings (Settings > MCP)\n- MCP tools can only be run using the Agent chat profile (Cursor Pro or Business subscription)\n- Use \"Yolo Mode\" to automatically run MCP tool requests\n\n\u003C\u002Fdetails>\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","godot-mcp 是一个用于与 Godot 游戏引擎交互的 MCP 服务器，提供了启动编辑器、运行项目和捕获调试输出的工具。该项目使用 JavaScript 编写，并结合了 Node.js 和 TypeScript 技术，确保了高效稳定的运行环境。它支持通过命令行或图形界面操作 Godot 引擎，特别适用于需要频繁调试和快速迭代的游戏开发场景。MIT 许可证下的开源性质也使得开发者可以自由地对其进行修改和分发。",2,"2026-06-11 03:43:08","high_star"]