[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Coding-Solo--godot-mcp":3,"tool-Coding-Solo--godot-mcp":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":78,"owner_location":79,"owner_email":78,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":91,"forks":92,"last_commit_at":93,"license":94,"difficulty_score":23,"env_os":95,"env_gpu":95,"env_ram":95,"env_deps":96,"category_tags":102,"github_topics":103,"view_count":23,"oss_zip_url":78,"oss_zip_packed_at":78,"status":16,"created_at":107,"updated_at":108,"faqs":109,"releases":137},3513,"Coding-Solo\u002Fgodot-mcp","godot-mcp","MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.","godot-mcp 是一款专为 Godot 游戏引擎打造的模型上下文协议（MCP）服务器，旨在搭建 AI 智能体与游戏开发环境之间的桥梁。它允许 AI 直接操控 Godot 编辑器，执行启动项目、运行游戏场景以及实时捕获调试输出等关键操作。\n\n在传统开发流程中，AI 往往只能基于静态代码提供建议，无法验证代码在实际引擎中的运行效果。godot-mcp 通过建立“执行 - 反馈”闭环，有效解决了这一痛点：AI 不仅能生成代码，还能亲自“运行”并观察结果，从而更精准地定位错误、优化逻辑，显著提升辅助编程的可靠性。\n\n这款工具特别适合使用 Godot 引擎的游戏开发者、技术美术以及希望利用 AI 加速原型设计的独立创作者。对于正在探索 AI 自主编程能力的研究人员而言，它也是一个极佳的实践案例。其核心技术亮点在于基于 Node.js 和 TypeScript 构建，轻量且易于集成，能够将原本孤立的代码生成过程转化为动态的交互式开发体验，让 AI 真正成为懂引擎、能实操的开发伙伴。","# 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\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\n用于与 Godot 游戏引擎交互的模型上下文协议（MCP）服务器。\n\n## 简介\n\nGodot MCP 允许 AI 代理启动 Godot 编辑器、运行项目、捕获调试输出并控制项目执行。这种直接的反馈回路有助于代理了解在实际 Godot 项目中哪些有效、哪些无效，从而生成更优质的代码并提供更好的调试支持。\n\n## 特性\n\n- **启动 Godot 编辑器**：打开特定项目的 Godot 编辑器\n- **运行 Godot 项目**：以调试模式执行 Godot 项目\n- **捕获调试输出**：获取控制台输出和错误信息\n- **控制执行**：以编程方式启动和停止 Godot 项目\n- **获取 Godot 版本**：检索已安装的 Godot 版本\n- **列出 Godot 项目**：在指定目录中查找 Godot 项目\n- **项目分析**：获取项目结构的详细信息\n- **场景管理**：\n  - 创建具有指定根节点类型的全新场景\n  - 向现有场景添加带有自定义属性的节点\n  - 将精灵和纹理加载到 Sprite2D 节点中\n  - 将 3D 场景导出为 GridMap 的 MeshLibrary 资源\n  - 保存场景，并可选择创建变体\n- **UID 管理**（适用于 Godot 4.4 及以上版本）：\n  - 获取特定文件的 UID\n  - 通过重新保存资源更新 UID 引用\n\n## 需求\n\n- 您的系统上已安装 [Godot 引擎](https:\u002F\u002Fgodotengine.org\u002Fdownload)\n- Node.js（>=18.0.0）和 npm\n- 支持 MCP 的 AI 代理\n\n## 快速入门\n\n### Claude Code\n\n```bash\nclaude mcp add godot -- npx @coding-solo\u002Fgodot-mcp\n```\n\n就是这样。重启 Claude Code 后，你的 Godot MCP 工具即可使用。\n\n使用环境变量：\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\n将以下内容添加到你的 Cline MCP 设置文件（`~\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**使用 Cursor UI：**\n\n1. 前往 **Cursor 设置** > **功能** > **MCP**\n2. 点击 **+ 添加新 MCP 服务器** 按钮\n3. 填写表单：\n   - 名称：`godot`\n   - 类型：`命令`\n   - 命令：`npx @coding-solo\u002Fgodot-mcp`\n4. 点击“添加”\n5. 你可能需要在 MCP 服务器卡片的右上角按下刷新按钮，以加载工具列表\n\n**使用项目特定配置：**\n\n在你的项目目录下创建 `.cursor\u002Fmcp.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    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>其他 MCP 客户端\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n对于任何兼容 MCP 的客户端，请使用以下配置：\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### 环境变量\n\n| 变量       | 描述                           |\n|------------|--------------------------------|\n| `GODOT_PATH` | Godot 可执行文件的路径（覆盖自动检测） |\n| `DEBUG`    | 设置为 `\"true\"` 以启用详细的服务器端调试日志 |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>从源代码构建\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\n然后让你的 MCP 客户端指向 `build\u002Findex.js`，而不是使用 `npx`。\n\u003C\u002Fdetails>\n\n\n## 架构\n\nGodot MCP 服务器采用捆绑 GDScript 的方式来处理复杂操作：\n\n1. **直接命令**：像启动编辑器或获取项目信息这样的简单操作，直接使用 Godot 内置的 CLI 命令。\n2. **捆绑操作脚本**：对于创建场景或添加节点等复杂操作，则使用一个全面的 GDScript 文件（`godot_operations.gd`），该文件负责处理所有相关操作。\n\n这个捆绑脚本接受操作类型和参数的 JSON 格式输入，从而实现灵活且动态的操作执行，而无需为每次操作生成临时文件。\n\n## 故障排除\n\n- **未找到 Godot**：请设置 `GODOT_PATH` 环境变量，指向你的 Godot 可执行文件路径。\n- **连接问题**：确保服务器正在运行，并重启你的 AI 助手。\n- **无效的项目路径**：请确认路径指向包含 `project.godot` 文件的目录。\n- **构建问题**：请确保已安装所有依赖项，运行 `npm install`。\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor 特定问题\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- 确保 MCP 服务器已在 Cursor 设置中显示并启用（设置 > MCP）。\n- MCP 工具只能通过 Agent 聊天个人资料运行（Cursor Pro 或 Business 订阅）。\n- 使用“Yolo 模式”可自动执行 MCP 工具请求。\n\n\u003C\u002Fdetails>\n\n## 许可证\n\n本项目采用 MIT 许可证授权——详情请参阅 [LICENSE](LICENSE) 文件。","# Godot MCP 快速上手指南\n\nGodot MCP 是一个基于 Model Context Protocol (MCP) 的服务器工具，它允许 AI 助手（如 Claude Code、Cursor、Cline）直接与 Godot 游戏引擎交互。通过该工具，AI 可以启动编辑器、运行项目、捕获调试输出、管理场景节点以及处理资源 UID，从而实现更智能的代码生成和自动化调试。\n\n## 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **Godot 引擎**：已安装 Godot Engine（推荐最新稳定版）。\n*   **Node.js**：版本需 >= 18.0.0。\n*   **npm**：随 Node.js 一同安装。\n*   **MCP 兼容客户端**：如 Claude Code、Cursor 或 Cline 等支持 MCP 协议的 AI 开发工具。\n\n## 安装步骤\n\nGodot MCP 无需手动克隆仓库即可使用，可通过 `npx` 直接运行。根据您的 AI 客户端选择以下一种配置方式：\n\n### 方式一：Claude Code (命令行配置)\n\n在终端中运行以下命令将 Godot MCP 添加到 Claude Code：\n\n```bash\nclaude mcp add godot -- npx @coding-solo\u002Fgodot-mcp\n```\n\n如果需要指定 Godot 路径或开启调试模式：\n\n```bash\nclaude mcp add godot -e GODOT_PATH=\u002Fpath\u002Fto\u002Fgodot -e DEBUG=true -- npx @coding-solo\u002Fgodot-mcp\n```\n*(请将 `\u002Fpath\u002Fto\u002Fgodot` 替换为您实际的 Godot 可执行文件路径)*\n\n### 方式二：Cursor (图形界面或配置文件)\n\n**方法 A：通过 UI 设置**\n1. 打开 **Cursor Settings** > **Features** > **MCP**。\n2. 点击 **+ Add New MCP Server**。\n3. 填写表单：\n   - **Name**: `godot`\n   - **Type**: `command`\n   - **Command**: `npx @coding-solo\u002Fgodot-mcp`\n4. 点击 \"Add\" 并刷新列表。\n\n**方法 B：项目级配置**\n在项目根目录创建 `.cursor\u002Fmcp.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    }\n  }\n}\n```\n\n### 方式三：Cline (配置文件)\n\n编辑 Cline 的 MCP 设置文件 (`~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json` Windows 用户路径类似)，添加以下配置：\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\", \"run_project\", \"get_debug_output\", \"stop_project\",\n        \"get_godot_version\", \"list_projects\", \"get_project_info\", \"create_scene\",\n        \"add_node\", \"load_sprite\", \"export_mesh_library\", \"save_scene\",\n        \"get_uid\", \"update_project_uids\"\n      ]\n    }\n  }\n}\n```\n\n## 基本使用\n\n配置完成后，重启您的 AI 客户端。您现在可以在对话中直接使用自然语言指令控制 Godot。\n\n**使用示例：**\n\n1.  **检查环境与版本**\n    > \"检查当前安装的 Godot 版本，并列出当前目录下的所有 Godot 项目。\"\n\n2.  **运行与调试**\n    > \"以调试模式运行当前的 Godot 项目，并捕获控制台输出的错误信息。\"\n    > \"停止正在运行的项目实例。\"\n\n3.  **场景与节点管理**\n    > \"创建一个新场景，根节点类型为 'Node2D'。\"\n    > \"在当前场景中加载一个 Sprite2D 节点，并将 'player.png' 设置为纹理。\"\n    > \"将当前的 3D 场景导出为 MeshLibrary 资源以便用于 GridMap。\"\n\n4.  **高级操作 (Godot 4.4+)**\n    > \"获取 'res:\u002F\u002Fscenes\u002Fmain.tscn' 文件的 UID，并更新项目中所有对该资源的引用。\"\n\n**提示**：若 AI 无法自动找到 Godot 可执行文件，请在配置中添加 `GODOT_PATH` 环境变量指向您的 Godot 安装路径。","独立游戏开发者小李正试图让 AI 助手帮他修复一个复杂的 Godot 物理碰撞 Bug，该问题仅在特定场景运行时会随机触发。\n\n### 没有 godot-mcp 时\n- **手动操作繁琐**：小李必须亲自切换窗口启动 Godot 编辑器，加载项目并点击运行，无法让 AI 直接执行测试。\n- **调试信息割裂**：当游戏崩溃或报错时，控制台输出停留在本地终端，AI 无法自动获取错误日志，只能靠小李截图或复制粘贴。\n- **迭代效率低下**：每次修改代码后，都需要人工重复“保存 - 启动 - 观察 - 反馈”的循环，导致验证修复方案耗时极长。\n- **上下文缺失**：AI 仅凭代码文本猜测问题，缺乏对实际运行状态（如帧率波动、物理引擎报错）的感知，给出的建议往往不切实际。\n\n### 使用 godot-mcp 后\n- **自动化执行**：小李只需下达指令，godot-mcp 即可直接操控 AI 启动 Godot 编辑器并运行指定项目，实现全流程自动化。\n- **实时日志捕获**：godot-mcp 能自动抓取运行时的调试输出和崩溃堆栈，并即时反馈给 AI，让其精准定位错误根源。\n- **闭环快速迭代**：AI 可根据捕获的错误自动修改代码，并通过 godot-mcp 立即重新运行验证，将数分钟的等待缩短为秒级响应。\n- **感知真实环境**：godot-mcp 让 AI 拥有了“眼睛”和“耳朵”，能基于真实的引擎运行数据提供符合物理逻辑的修复方案。\n\ngodot-mcp 通过打通 AI 与 Godot 引擎的执行壁垒，将原本割裂的“编码 - 测试”环节转化为高效的自动化闭环，极大提升了游戏开发调试效率。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FCoding-Solo_godot-mcp_989f83d6.png","Coding-Solo","Solomon Elias","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FCoding-Solo_8f398a6b.jpg",null,"Florida","https:\u002F\u002Fsolomonelias.com\u002F","https:\u002F\u002Fgithub.com\u002FCoding-Solo",[83,87],{"name":84,"color":85,"percentage":86},"JavaScript","#f1e05a",59.1,{"name":88,"color":89,"percentage":90},"GDScript","#355570",40.9,2853,291,"2026-04-04T18:49:40","MIT","未说明",{"notes":97,"python":95,"dependencies":98},"该工具是一个 MCP 服务器，用于与 Godot 游戏引擎交互。需要安装 Godot 引擎并在系统中可用。支持通过环境变量 GODOT_PATH 指定 Godot 可执行文件路径。主要依赖 Node.js 环境运行，而非 Python。AI 代理需支持 MCP 协议（如 Claude Code, Cline, Cursor 等）。",[99,100,101],"Node.js (>=18.0.0)","npm","Godot Engine",[14,15,13],[104,105,106],"ai","godot","mcp","2026-03-27T02:49:30.150509","2026-04-06T09:46:10.698007",[110,115,120,125,129,133],{"id":111,"question_zh":112,"answer_zh":113,"source_url":114},16104,"为什么在使用 Claude Desktop 或其他 MCP 客户端时会报 'Unexpected token ... is not valid JSON' 错误？","这是因为 MCP 协议要求 stdout（标准输出）只能包含有效的 JSON-RPC 消息，但 godot-mcp 将调试信息（如 [DEBUG]...）也输出到了 stdout，导致客户端解析失败。\n\n解决方案是确保所有非 JSON-RPC 的日志（包括 console.debug, console.warn, console.log）都重定向到 stderr（标准错误输出）。具体代码修改如下：\n1. 将 logDebug 函数中的 console.debug 改为 console.error。\n2. 将所有 console.warn 替换为 console.error。\n3. 将服务器状态信息的 console.log 也改为 console.error。\n\n修改后需重新构建项目（运行 npm run build），确保 stdout 仅用于协议通信。","https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fissues\u002F24",{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},16105,"调用 create_scene 或 save_scene 工具时，报错 'Failed to parse JSON parameters' 且提示参数格式错误怎么办？","该问题通常是因为传递给 Godot 脚本的参数字符串格式不正确。错误日志显示参数变成了类似 '{scene_path:test_scene.tscn}' 的形式（缺少双引号），而正确的 JSON 格式应为 '{\"scene_path\":\"test_scene.tscn\"}'。\n\n维护者已在最新提交中修复了此问题，主要涉及两个方面：\n1. 修复了参数映射逻辑，确保驼峰命名（camelCase）能正确转换为 Godot 需要的蛇形命名（snake_case）。\n2. 修复了 JSON 序列化过程，确保传递给 Godot 的字符串包含正确的双引号。\n\n如果遇到此问题，请拉取最新代码并重新构建（npm run build）。如果问题依旧，请检查传入的参数是否符合 API 定义的 camelCase 格式。","https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fissues\u002F9",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},16106,"godot-mcp 是否存在远程代码执行（RCE）漏洞？如何验证和修复？","是的，早期版本中存在因 projectPath 参数未进行适当转义而导致的命令注入漏洞。攻击者可以通过构造包含 shell 元字符（如 $(id>\u002Ftmp\u002FTEST)）的项目路径来执行任意命令。\n\n验证方法：\n在 MCP Inspector 中调用工具（如 create_scene），将 projectPath 设置为包含恶意负载的路径，例如：\n\"projectPath\": \"\u002Fhome\u002Fprojects\u002Ftest\u002F$(id>\u002Ftmp\u002FTEST)\"\n如果在主分支（main）上执行后创建了 TEST 文件，则说明存在漏洞。\n\n修复方案：\n维护者已发布修复补丁。请在修复后的分支上重新运行 npm run build 进行构建。修复后，同样的恶意输入将不再创建文件，因为用户输入已被正确处理，不再被 shell 解释执行。建议所有用户尽快更新到最新版本。","https:\u002F\u002Fgithub.com\u002FCoding-Solo\u002Fgodot-mcp\u002Fissues\u002F64",{"id":126,"question_zh":127,"answer_zh":128,"source_url":119},16107,"如何在 VSCode Copilot Chat 或 Agent 模式下正确使用 godot-mcp 的场景保存功能？","在 VSCode Copilot Chat (Agent mode) 中使用 save_scene 工具时，如果遇到 'Invalid access to property or key' 错误，通常是因为底层 JSON 参数传递格式问题（见相关 JSON 解析错误修复）。\n\n确保操作步骤如下：\n1. 更新 godot-mcp 到最新版本以获取 JSON 格式化修复。\n2. 调用工具时，参数必须严格符合 schema 定义。例如：\n{\n  \"projectPath\": \"c:\\\\projects\\\\games\\\\ai-survivors\",\n  \"scenePath\": \"scenes\u002Fgame.tscn\"\n}\n3. 确保路径中的反斜杠已正确转义（在 JSON 字符串中通常为双反斜杠 \\\\）。\n4. 确认对目标路径有写入权限。\n如果更新后仍报错，请检查 godot-mcp 的调试日志（输出到 stderr）以获取更详细的 Godot 脚本错误信息。",{"id":130,"question_zh":131,"answer_zh":132,"source_url":114},16108,"MCP Inspector 测试通过但集成到 Claude Desktop 仍然失败，可能是什么原因？","如果 MCP Inspector 测试正常但 Claude Desktop 报错（如 JSON 解析错误），最常见的原因是 stdout\u002Fstderr 混用问题未被彻底解决，或者使用的不是修复后的构建版本。\n\n排查步骤：\n1. 确认代码已应用了将 console.debug\u002Flog\u002Fwarn 改为 console.error 的修复。\n2. 务必在修改代码后运行 npm run build 重新构建项目，直接运行源码可能不会生效。\n3. 检查 Claude Desktop 的配置，确保指向的是构建后的正确入口文件。\n4. 查看 Claude Desktop 的日志，如果依然看到 \"[DEBUG]...\" 开头的非 JSON 内容，说明修复未生效或日志配置有误。\n维护者确认该修复在重新构建后可解决与严格遵循协议的客户端（如 Claude）的兼容性问题。",{"id":134,"question_zh":135,"answer_zh":136,"source_url":119},16109,"遇到 'SCRIPT ERROR: Invalid access to property or key ... on a base object of type Nil' 错误如何解决？","这个 Godot 脚本错误通常是由于上游（Node.js 端）传递的参数解析失败，导致传递给 GDScript 的参数对象为空（Nil）或格式错误。\n\n主要原因及解决：\n1. JSON 格式错误：参数被错误地序列化为无引号的字符串（如 {key:value} 而非 {\"key\":\"value\"}）。请更新至最新版本，该问题已在代码库中修复。\n2. 参数命名不匹配：API 要求使用 camelCase（如 scenePath），但内部转换可能出错。确保输入参数名称正确，并更新到修复了参数映射逻辑的版本。\n3. 重新构建：修改代码后必须执行 npm run build，否则运行的仍是旧版本的逻辑。\n如果问题持续，请提供完整的错误堆栈和输入参数，以便进一步排查是否为特定路径或权限问题。",[]]