[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-jackwrichards--UnityMCP":3,"tool-jackwrichards--UnityMCP":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},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,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},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 真正成长为懂上",151314,2,"2026-04-11T23:32:58",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":65,"owner_company":75,"owner_location":65,"owner_email":65,"owner_twitter":65,"owner_website":65,"owner_url":76,"languages":77,"stars":90,"forks":91,"last_commit_at":92,"license":93,"difficulty_score":94,"env_os":95,"env_gpu":96,"env_ram":96,"env_deps":97,"category_tags":103,"github_topics":65,"view_count":32,"oss_zip_url":65,"oss_zip_packed_at":65,"status":17,"created_at":104,"updated_at":105,"faqs":106,"releases":135},6823,"jackwrichards\u002FUnityMCP","UnityMCP",null,"UnityMCP 是一款专为 Unity 引擎打造的编辑器插件，它基于模型上下文协议（MCP），在 Unity 编辑器与 AI 助手之间搭建起一座实时沟通的桥梁。传统开发中，开发者往往需要手动在编辑器与代码环境间切换，或依赖繁琐的脚本调试来验证想法，而 UnityMCP 彻底改变了这一流程。它允许用户通过自然语言直接指挥 AI 读取当前场景状态、执行 C# 代码命令以及筛选查看运行日志，实现了“所说即所得”的交互式开发体验。\n\n这款工具特别适合 Unity 游戏开发者、技术美术以及希望利用 AI 提升原型设计效率的研究人员。其核心亮点在于内置了安全的 C# 代码执行引擎，能够直接调用 UnityEngine 和 UnityEditor API，让 AI 不仅能“看”懂场景层级和物体属性，还能实时修改对象位置、切换播放模式或自动化执行复杂任务。同时，它提供完善的连接监控与日志过滤功能，确保操作过程透明可控。只需简单配置，用户即可在 Claude 等 AI 桌面端直接操控 Unity 编辑器，将重复性的机械操作转化为高效的对话协作，显著降低开发门槛并加速创意落地。","# UnityMCP [![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white 'LinkedIn')](https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fjack-w-richards\u002F)\r\n\r\n\r\n\r\n[![](https:\u002F\u002Fbadge.mcpx.dev?type=server 'MCP Server')](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction)\r\n[![smithery badge](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjackwrichards_UnityMCP_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@Arodoid\u002Funitymcp)\r\n\r\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FArodoid\u002FUnityMCP 'Last Commit')](https:\u002F\u002Fgithub.com\u002FCoderGamester\u002Fmcp-unity\u002Fcommits\u002Fmain)\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fpulls\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-pr\u002FArodoid\u002FUnityMCP\" alt=\"Pull Requests Badge\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fissues\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FArodoid\u002FUnityMCP\" alt=\"Issues Badge\"\u002F>\u003C\u002Fa>\r\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-red.svg 'MIT License')](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\r\n\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FArodoid\u002FUnityMCP\" alt=\"Stars Badge\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fnetwork\u002Fmembers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FArodoid\u002FUnityMCP\" alt=\"Forks Badge\"\u002F>\u003C\u002Fa>\r\n\r\n\r\nUnityMCP is a powerful Unity Editor plugin that implements the Model Context Protocol (MCP), enabling seamless integration between Unity and AI assistants. It provides real-time editor state monitoring, remote command execution, and comprehensive logging capabilities.\r\n\r\n![UnityMCP](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjackwrichards_UnityMCP_readme_cff28d605426.png)\r\n\r\n## Architecture\r\n\r\nThe project consists of two main components:\r\n\r\n### 1. Unity Plugin (UnityMCPPlugin)\r\n\r\nA Unity Editor plugin that provides:\r\n- Debug window for connection status and monitoring\r\n- WebSocket client for real-time communication\r\n- C# code execution engine\r\n- Comprehensive logging system\r\n- Editor state tracking and serialization\r\n\r\n### 2. MCP Server (unity-mcp-server)\r\n\r\nA TypeScript-based MCP server that exposes Unity Editor functionality through standardized tools:\r\n\r\n#### Available Tools\r\n\r\n1. `get_editor_state`\r\n   - Retrieves current Unity Editor state\r\n   - Includes active GameObjects, selection state, play mode status\r\n   - Provides scene hierarchy and project structure\r\n   - Supports different output formats (Raw, scripts only, no scripts)\r\n\r\n2. `execute_editor_command`\r\n   - Executes C# code directly in the Unity Editor\r\n   - Full access to UnityEngine and UnityEditor APIs\r\n   - Real-time execution with comprehensive error handling\r\n   - Command timeout protection\r\n\r\n3. `get_logs`\r\n   - Retrieves and filters Unity Editor logs\r\n   - Supports filtering by type, content, and timestamp\r\n   - Customizable output fields\r\n   - Buffer management for optimal performance\r\n\r\n## Installation\r\n\r\n### Installing via Smithery\r\n\r\nTo install UnityMCP for Claude Desktop automatically via [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@Arodoid\u002Funitymcp):\r\n\r\n```bash\r\nnpx -y @smithery\u002Fcli install @Arodoid\u002Funitymcp --client claude\r\n```\r\n\r\n### Prerequisites\r\n- Unity 2022.3 or later\r\n- Node.js 18 or later\r\n- npm 9 or later\r\n\r\n### Unity Plugin Setup\r\n\r\n1. Copy the `UnityMCPPlugin` folder to your Unity project's Assets directory\r\n2. Open Unity Editor\r\n3. Access the plugin through Unity's top menu bar > UnityMCP > Debug Window\r\n\r\n### MCP Server Setup\r\n\r\n```bash\r\ncd unity-mcp-server\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n## Usage\r\n\r\n### Starting the Server\r\n\r\n```bash\r\ncd unity-mcp-server\r\nnode build\u002Findex.js\r\n```\r\n\r\n### Connecting from Unity\r\n\r\n1. Open your Unity project\r\n2. Open the UnityMCP Debug Window (Window > UnityMCP > Debug Window)\r\n3. The plugin will automatically attempt to connect to the MCP server\r\n4. Monitor connection status and logs in the debug window\r\n\r\n### Example: Executing Commands\r\n\r\n```csharp\r\n\u002F\u002F Center the selected object\r\nSelection.activeGameObject.transform.position = Vector3.zero;\r\n\r\n\u002F\u002F Toggle play mode\r\nEditorApplication.isPlaying = !EditorApplication.isPlaying;\r\n\r\n\u002F\u002F Create a new cube\r\nGameObject.CreatePrimitive(PrimitiveType.Cube);\r\n```\r\n\r\n## Development\r\n\r\n### Building the Server\r\n\r\n```bash\r\ncd unity-mcp-server\r\nnpm run build\r\n```\r\n\r\n### Watching for Changes\r\n\r\n```bash\r\nnpm run watch\r\n```\r\n\r\n### Inspecting MCP Communication\r\n\r\n```bash\r\nnpm run inspector\r\n```\r\n\r\n## Technical Details\r\n\r\n### Communication Protocol\r\n\r\n- WebSocket-based communication on port 8080\r\n- Bidirectional real-time updates\r\n- JSON message format for all communications\r\n- Automatic reconnection handling\r\n\r\n### Security Features\r\n\r\n- Command execution timeout protection\r\n- Error handling and validation\r\n- Log buffer management\r\n- Connection state monitoring\r\n\r\n### Error Handling\r\n\r\nThe system provides comprehensive error handling for:\r\n- Connection issues\r\n- Command execution failures\r\n- Compilation errors\r\n- Runtime exceptions\r\n- Timeout scenarios\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create your feature branch (`git checkout -b feature\u002Famazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\r\n4. Push to the branch (`git push origin feature\u002Famazing-feature`)\r\n5. Open a Pull Request\r\n\r\n## License\r\n\r\nThis project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).\r\n","# UnityMCP [![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white 'LinkedIn')](https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fjack-w-richards\u002F)\n\n[![](https:\u002F\u002Fbadge.mcpx.dev?type=server 'MCP Server')](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction)\n[![smithery badge](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjackwrichards_UnityMCP_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@Arodoid\u002Funitymcp)\n\n[![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FArodoid\u002FUnityMCP 'Last Commit')](https:\u002F\u002Fgithub.com\u002FCoderGamester\u002Fmcp-unity\u002Fcommits\u002Fmain)\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fpulls\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-pr\u002FArodoid\u002FUnityMCP\" alt=\"Pull Requests Badge\"\u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fissues\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FArodoid\u002FUnityMCP\" alt=\"Issues Badge\"\u002F>\u003C\u002Fa>\n[![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-red.svg 'MIT License')](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FArodoid\u002FUnityMCP\" alt=\"Stars Badge\"\u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FArodoid\u002FUnityMCP\u002Fnetwork\u002Fmembers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FArodoid\u002FUnityMCP\" alt=\"Forks Badge\"\u002F>\u003C\u002Fa>\n\nUnityMCP 是一款功能强大的 Unity 编辑器插件，实现了模型上下文协议（MCP），能够实现 Unity 与 AI 助手之间的无缝集成。它提供实时编辑器状态监控、远程命令执行以及全面的日志记录功能。\n\n![UnityMCP](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjackwrichards_UnityMCP_readme_cff28d605426.png)\n\n## 架构\n\n该项目由两个主要组件组成：\n\n### 1. Unity 插件（UnityMCPPlugin）\n\n一个 Unity 编辑器插件，提供以下功能：\n- 用于连接状态和监控的调试窗口\n- 用于实时通信的 WebSocket 客户端\n- C# 代码执行引擎\n- 全面的日志系统\n- 编辑器状态跟踪和序列化\n\n### 2. MCP 服务器（unity-mcp-server）\n\n一个基于 TypeScript 的 MCP 服务器，通过标准化工具公开 Unity 编辑器的功能：\n\n#### 可用工具\n\n1. `get_editor_state`\n   - 获取当前 Unity 编辑器状态\n   - 包括活动的游戏对象、选中状态、播放模式状态\n   - 提供场景层级和项目结构\n   - 支持不同输出格式（原始、仅脚本、无脚本）\n\n2. `execute_editor_command`\n   - 直接在 Unity 编辑器中执行 C# 代码\n   - 完全访问 UnityEngine 和 UnityEditor API\n   - 实时执行并具有全面的错误处理\n   - 命令超时保护\n\n3. `get_logs`\n   - 检索并过滤 Unity 编辑器日志\n   - 支持按类型、内容和时间戳进行过滤\n   - 可自定义输出字段\n   - 缓冲区管理以优化性能\n\n## 安装\n\n### 通过 Smithery 安装\n\n要通过 [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@Arodoid\u002Funitymcp) 自动为 Claude Desktop 安装 UnityMCP：\n\n```bash\nnpx -y @smithery\u002Fcli install @Arodoid\u002Funitymcp --client claude\n```\n\n### 先决条件\n- Unity 2022.3 或更高版本\n- Node.js 18 或更高版本\n- npm 9 或更高版本\n\n### Unity 插件设置\n\n1. 将 `UnityMCPPlugin` 文件夹复制到您的 Unity 项目 Assets 目录中\n2. 打开 Unity 编辑器\n3. 通过 Unity 的顶部菜单栏 > UnityMCP > 调试窗口访问插件\n\n### MCP 服务器设置\n\n```bash\ncd unity-mcp-server\nnpm install\nnpm run build\n```\n\n## 使用\n\n### 启动服务器\n\n```bash\ncd unity-mcp-server\nnode build\u002Findex.js\n```\n\n### 从 Unity 连接\n\n1. 打开您的 Unity 项目\n2. 打开 UnityMCP 调试窗口（Window > UnityMCP > 调试窗口）\n3. 插件将自动尝试连接到 MCP 服务器\n4. 在调试窗口中监控连接状态和日志\n\n### 示例：执行命令\n\n```csharp\n\u002F\u002F 将选中的对象居中\nSelection.activeGameObject.transform.position = Vector3.zero;\n\n\u002F\u002F 切换播放模式\nEditorApplication.isPlaying = !EditorApplication.isPlaying;\n\n\u002F\u002F 创建一个新的立方体\nGameObject.CreatePrimitive(PrimitiveType.Cube);\n```\n\n## 开发\n\n### 构建服务器\n\n```bash\ncd unity-mcp-server\nnpm run build\n```\n\n### 监视更改\n\n```bash\nnpm run watch\n```\n\n### 检查 MCP 通信\n\n```bash\nnpm run inspector\n```\n\n## 技术细节\n\n### 通信协议\n\n- 基于 WebSocket 的通信，使用 8080 端口\n- 双向实时更新\n- 所有通信均采用 JSON 消息格式\n- 自动重连处理\n\n### 安全特性\n\n- 命令执行超时保护\n- 错误处理和验证\n- 日志缓冲区管理\n- 连接状态监控\n\n### 错误处理\n\n系统提供全面的错误处理机制，用于处理：\n- 连接问题\n- 命令执行失败\n- 编译错误\n- 运行时异常\n- 超时情况\n\n## 贡献\n\n1. 分支仓库\n2. 创建功能分支 (`git checkout -b feature\u002Famazing-feature`)\n3. 提交更改 (`git commit -m '添加惊人功能'`)\n4. 推送到分支 (`git push origin feature\u002Famazing-feature`)\n5. 打开拉取请求\n\n## 许可证\n\n本项目采用知识共享署名-非商业性使用 4.0 国际许可协议（CC BY-NC 4.0）授权。","# UnityMCP 快速上手指南\n\nUnityMCP 是一款强大的 Unity Editor 插件，基于模型上下文协议（MCP）构建，能够实现 Unity 编辑器与 AI 助手的无缝集成。它支持实时编辑器状态监控、远程 C# 命令执行以及全面的日志管理功能。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **Unity**: 2022.3 或更高版本\n*   **Node.js**: 18 或更高版本\n*   **npm**: 9 或更高版本\n*   **操作系统**: Windows, macOS 或 Linux\n\n> **提示**：国内开发者若遇到 npm 安装缓慢的问题，可临时切换至淘宝镜像源：\n> `npm config set registry https:\u002F\u002Fregistry.npmmirror.com`\n\n## 安装步骤\n\n### 1. 安装 MCP Server (服务端)\n\n克隆项目或直接下载源码后，在终端进入 `unity-mcp-server` 目录进行构建：\n\n```bash\ncd unity-mcp-server\nnpm install\nnpm run build\n```\n\n*(可选) 如果您使用 Claude Desktop 且希望通过 Smithery 自动安装配置：*\n```bash\nnpx -y @smithery\u002Fcli install @Arodoid\u002Funitymcp --client claude\n```\n\n### 2. 安装 Unity Plugin (客户端)\n\n1.  将项目中的 `UnityMCPPlugin` 文件夹复制到您的 Unity 项目的 `Assets` 目录下。\n2.  打开或重启 Unity Editor。\n3.  在顶部菜单栏选择 **UnityMCP > Debug Window** 即可看到插件界面。\n\n## 基本使用\n\n### 第一步：启动服务\n\n在终端中运行构建好的服务端程序（默认监听 8080 端口）：\n\n```bash\ncd unity-mcp-server\nnode build\u002Findex.js\n```\n\n### 第二步：连接 Unity\n\n1.  在 Unity 编辑器中打开 **Window > UnityMCP > Debug Window**。\n2.  插件会自动尝试连接本地运行的 MCP 服务器。\n3.  观察调试窗口中的状态指示器，确认连接成功（通常显示为绿色或 \"Connected\"）。\n\n### 第三步：执行命令示例\n\n连接成功后，您可以通过 AI 助手或直接调用工具向 Unity 发送 C# 指令。以下是几个典型的操作示例：\n\n**示例 1：重置选中物体位置**\n```csharp\n\u002F\u002F 将当前选中的 GameObject 移动到世界原点\nSelection.activeGameObject.transform.position = Vector3.zero;\n```\n\n**示例 2：切换播放模式**\n```csharp\n\u002F\u002F 切换 Play 模式的开启\u002F关闭状态\nEditorApplication.isPlaying = !EditorApplication.isPlaying;\n```\n\n**示例 3：创建基础几何体**\n```csharp\n\u002F\u002F 在当前场景创建一个立方体\nGameObject.CreatePrimitive(PrimitiveType.Cube);\n```\n\n执行上述命令后，您将立即在 Unity 场景中看到对应的变化，同时可以在 Debug Window 中查看执行日志和结果。","独立游戏开发者正在赶制原型，需要快速调整场景中数十个敌人的生成位置并验证逻辑，同时确保不中断当前的测试流程。\n\n### 没有 UnityMCP 时\n- **反复手动操作**：开发者必须频繁在代码编辑器和 Unity 编辑器之间切换，手动选中每个敌人对象并在 Inspector 面板逐个修改坐标，效率极低。\n- **调试中断沉浸感**：为了验证修改效果，不得不停止 Play 模式、重新编译代码再启动，打断了测试节奏和创作心流。\n- **日志排查困难**：当生成逻辑报错时，需要在杂乱的 Console 窗口中肉眼筛选特定时间段的错误信息，难以定位具体是哪个脚本引发了异常。\n- **状态感知滞后**：无法实时获知编辑器当前的层级结构或选中状态，往往凭记忆操作，容易导致误改其他无关对象。\n\n### 使用 UnityMCP 后\n- **自然语言批量操控**：开发者直接对 AI 助手说“将所有标记为 Enemy 的对象 X 轴坐标归零”，UnityMCP 即刻调用 `execute_editor_command` 在后台执行 C# 代码完成批量重置。\n- **无感热更新验证**：通过 MCP 协议实时下发指令，无需停止 Play 模式即可动态调整参数并立即观察效果，保持了完整的测试连续性。\n- **智能日志过滤**：请求 AI“获取最近 1 分钟包含 NullReference 的错误日志”，UnityMCP 利用 `get_logs` 工具精准提取关键信息并解释原因，秒级定位问题。\n- **实时上下文感知**：AI 通过 `get_editor_state` 实时读取当前场景层级和选中对象，确保所有指令都基于最新的编辑器状态执行，避免误操作。\n\nUnityMCP 将繁琐的编辑器手动操作转化为流畅的自然语言交互，让开发者从机械重复中解放，专注于核心玩法的创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjackwrichards_UnityMCP_cff28d60.gif","jackwrichards","Jack Richards","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fjackwrichards_cf3ac656.png","@fastly","https:\u002F\u002Fgithub.com\u002Fjackwrichards",[78,82,86],{"name":79,"color":80,"percentage":81},"C#","#178600",55.7,{"name":83,"color":84,"percentage":85},"JavaScript","#f1e05a",43,{"name":87,"color":88,"percentage":89},"Dockerfile","#384d54",1.3,517,54,"2026-04-02T13:11:12","NOASSERTION",4,"Windows, macOS, Linux","未说明",{"notes":98,"python":96,"dependencies":99},"该工具由 Unity 插件和 Node.js MCP 服务器组成。需安装 Unity 2022.3 或更高版本，以及 Node.js 18 和 npm 9 以上版本。通过 WebSocket 在端口 8080 进行通信。安装时需将插件文件夹复制到 Unity 项目的 Assets 目录，并手动构建运行 TypeScript 服务器。",[100,101,102],"Unity 2022.3+","Node.js 18+","npm 9+",[13,52],"2026-03-27T02:49:30.150509","2026-04-12T16:22:14.785773",[107,112,117,121,126,131],{"id":108,"question_zh":109,"answer_zh":110,"source_url":111},30773,"如何在 Claude Desktop 中配置 UnityMCP 服务器？","需要在 claude_desktop_config.json 文件中添加服务器配置。使用 'node' 作为命令，并指定构建好的 index.js 文件的绝对路径。示例配置如下：\n{\n  \"mcpServers\": {\n    \"unity\": {\n      \"command\": \"node\",\n      \"args\": [\n          \"C:\\\\MyProjectPath\\\\Assets\\\\UnityMCP\\\\unity-mcp-server\\\\build\\\\index.js\"\n      ]\n    }\n  }\n}\n确保路径中的反斜杠已正确转义（使用双反斜杠）。","https:\u002F\u002Fgithub.com\u002Fjackwrichards\u002FUnityMCP\u002Fissues\u002F5",{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},30774,"导入插件时遇到 Newtonsoft.Json 版本冲突或报错怎么办？","该问题通常由 Newtonsoft.Json 依赖版本过低引起。解决方法是升级依赖项至 3.2.1 版本。\n方法一：修改 package.json 文件，将 Newtonsoft.Json 依赖从 3.0.2 升级到 3.2.1。\n方法二：在项目的 Packages\u002Fmanifest.json 文件中显式添加以下依赖：\n{\n  \"dependencies\": {\n    \"com.unity.nuget.newtonsoft-json\": \"3.2.1\",\n    \"com.unity.textmeshpro\": \"3.0.7\"\n  }\n}","https:\u002F\u002Fgithub.com\u002Fjackwrichards\u002FUnityMCP\u002Fissues\u002F1",{"id":118,"question_zh":119,"answer_zh":120,"source_url":111},30775,"调用工具时报错\"Unity Editor is not connected\"是什么原因？","此错误表示 Node.js 服务器进程无法与 Unity 编辑器建立 WebSocket 连接。这通常不是 Claude 的问题，而是本地环境问题。请确认以下几点：\n1. Unity 编辑器正在运行。\n2. Unity 项目中已打开 UnityMCP Debug Window（调试窗口）。\n3. 注意：该项目目前主要作为概念验证（Proof of Concept），在某些环境下可能存在连接稳定性问题或端口冲突。如果标准方式无法连接，可能需要检查防火墙设置或考虑自定义插件方案（让 Unity 作为 WebSocket 服务端）。",{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},30776,"连接 UnityMCP 服务器应该使用什么命令（npx, python 还是 node）？","应该使用 'node' 命令来启动服务器。具体的命令格式为：\nnode PATH_TO_BUILD\u002Funity_mcp_server\u002Fbuild\u002Findex.js\n请将 'PATH_TO_BUILD' 替换为你实际的项目构建目录路径。不支持直接使用 npx 或 python 启动该特定服务器。","https:\u002F\u002Fgithub.com\u002Fjackwrichards\u002FUnityMCP\u002Fissues\u002F2",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},30777,"UnityMCP 项目的许可证是什么？可以用于商业用途吗？","该项目最初是私有仓库，目前的许可证状态为非商业用途（Non-commercial）。虽然接受贡献，但明确不授权用于公共商业使用。在使用前请务必注意这一限制。","https:\u002F\u002Fgithub.com\u002Fjackwrichards\u002FUnityMCP\u002Fissues\u002F4",{"id":132,"question_zh":133,"answer_zh":134,"source_url":111},30778,"UnityMCP 与 Claude 之间的通信架构是怎样的？","通信链路分为两段：\n1. Claude 通过 MCP 协议调用 UnityMCP 提供的工具（运行在 Node.js 环境中）。\n2. UnityMCP 服务器通过 WebSocket 与 Unity 编辑器进行通信。\n因此，Claude 并不直接连接 Unity，而是通过中间的 UnityMCP 服务器转发请求。如果 WebSocket 连接断开，即使 Claude 正常发送指令，也会报出\"Unity Editor is not connected\"的错误。",[]]