[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-kvick-games--UnrealMCP":3,"tool-kvick-games--UnrealMCP":64},[4,17,27,35,48,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 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[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},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,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"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,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"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":79,"owner_location":79,"owner_email":79,"owner_twitter":79,"owner_website":79,"owner_url":80,"languages":81,"stars":98,"forks":99,"last_commit_at":100,"license":79,"difficulty_score":101,"env_os":102,"env_gpu":103,"env_ram":103,"env_deps":104,"category_tags":110,"github_topics":79,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":111,"updated_at":112,"faqs":113,"releases":114},524,"kvick-games\u002FUnrealMCP","UnrealMCP","MCP to allow AI agents to control Unreal","UnrealMCP 是一款专为虚幻引擎设计的开源插件，核心目标是让 AI 智能体直接控制 Unreal Engine。它通过在引擎内实现机器控制协议（MCP），打通了外部 AI 系统与游戏环境的连接，允许人工智能通过编程方式自动操作场景、调整材质及管理资产。这一机制有效解决了传统开发中大量依赖人工手动操作的痛点，为探索 AI 驱动的自动化内容创作和工作流优化提供了新方案。\n\n由于涉及底层代码交互及潜在风险，UnrealMCP 更适合具备 C++ 开发经验的技术人员、研究人员或技术美术使用。目前它采用网络通信和 JSON 命令协议，支持编辑器 UI 集成，并配有 Python 脚本方便客户端调用，已验证可与 Claude for Desktop 等模型配合运行。\n\n值得注意的是，该项目仍处于早期实验阶段，主要支持 Windows 平台。鉴于 AI 拥有直接修改工程文件的权限，可能存在误删或覆盖的风险。使用者必须自行负责数据安全，强烈建议在启用前配置好 Git 或 Perforce 等版本控制系统，并定期备份项目，最好先在独立测试环境中熟悉功能。","# UnrealMCP Plugin\n\n\n[![Discord][discord-shield]][discord-url]\n\n[discord-shield]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=flat&logo=discord&logoColor=white\n[discord-url]: https:\u002F\u002Fdiscord.gg\u002FThkpVxdzet\n\n\n# VERY WIP REPO\nI'm working on adding more tools now and cleaning up the codebase, \nI plan to allow for easy tool extension outside the main plugin\n\nThis is very much a work in progress, and I need to clean up a lot of stuff!!!!!\n\nAlso, I only use windows, so I don't know how this would be setup for mac\u002Funix\n\n## Overview\nUnrealMCP is an Unofficial Unreal Engine plugin designed to control Unreal Engine with AI tools. It implements a Machine Control Protocol (MCP) within Unreal Engine, allowing external AI systems to interact with and manipulate the Unreal environment programmatically.\n\nI only just learned about MCP a few days ago, so I'm not that familiar with it, I'm still learning so things might be initially pretty rough.\nI've implemented this using https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fblender-mcp as a reference, which relies on claude for desktop. It may or may not work with other models, if you experiment with any, please let me know!\n\n## ⚠️ DISCLAIMER\nThis plugin allows AI agents to directly modify your Unreal Engine project. While it can be a powerful tool, it also comes with risks:\n\n- AI agents may make unexpected changes to your project\n- Files could be accidentally deleted or modified\n- Project settings could be altered\n- Assets could be overwritten\n\n**IMPORTANT SAFETY MEASURES:**\n1. Always use source control (like Git or Perforce) with your project\n2. Make regular backups of your project\n3. Test the plugin in a separate project first\n4. Review changes before committing them\n\nBy using this plugin, you acknowledge that:\n- You are solely responsible for any changes made to your project\n- The plugin author is not responsible for any damage, data loss, or issues caused by AI agents\n- You use this plugin at your own risk\n\n## Features\n- TCP server implementation for remote control of Unreal Engine\n- JSON-based command protocol for AI tools integration\n- Editor UI integration for easy access to MCP functionality\n- Comprehensive scene manipulation capabilities\n- Python companion scripts for client-side interaction\n\n## Roadmap\nThese are what I have in mind for development as of 3\u002F14\u002F2025\nI'm not sure what's possible yet, in theory anything, but it depends on how\ngood the integrated LLM is at utilizing these tools.\n- [X] Basic operations working\n- [X] Python working\n- [X] Materials\n- [ ] User Extensions (in progress)\n- [ ] Asset tools\n- [ ] Blueprints\n- [ ] Niagara VFX\n- [ ] Metasound\n- [ ] Landscape (I might hold off on this because Epic has mentioned they are going to be updating the landscape tools)\n- [ ] Modeling Tools\n- [ ] PCG\n\n## Requirements\n- Unreal Engine 5.5 (I have only tested on this version, may work with earlier, but no official support)\n- C++ development environment configured for Unreal Engine\n- Python 3.7+ for client-side scripting\n- Model to run the commands, in testing I've been using Claude for Desktop https:\u002F\u002Fclaude.ai\u002Fdownload\n\n## Installation\n1. Clone this repository into your Unreal project's `Plugins` directory:\n   ```\n   git clone https:\u002F\u002Fgithub.com\u002Fkvick-games\u002FUnrealMCP.git Plugins\u002FUnrealMCP\n   ```\n   The project path should match this pattern like so:\n...\\UNREAL_PROJECT\\Plugins\\UnrealMCP\\\n\n3. Regenerate your project files (right-click your .uproject file and select \"Generate Visual Studio project files\")\n4. Build the project in whatever IDE you use, I use Rider, Visual Studio works (working on releases now)\n5. Open your project and enable the plugin in Edit > Plugins > UnrealMCP\n6. Enable Python plugins in Unreal\n7. Run setup_unreal_mcp.bat (I probably need to make some fixes to this file as more people try it out)\n8. Currently I've only tested with Claude for Desktop so follow the instructions below to continue\n\n## With Claude for Desktop\nYou will need to find your installation directory for claude for desktop. Find claude_desktop_config.json and add an entry and make it look like so:\n```json\n{\n    \"mcpServers\": {\n        \"unreal\": {\n            \"command\": \"C:\\\\UnrealMCP_Project\\\\Plugins\\\\UnrealMCP\\\\MCP\\\\run_unreal_mcp.bat\",\n            \"args\": []\n        }\n    }\n}\n```\nIN THE COMMAND FIELD PUT YOUR PATH TO YOUR PLUGIN DIRECTORY POINTED TO THE SCRIPT: \"run_unreal_mcp.bat\"\nThis script is located within ..\u002Fplugin_root_directory\u002FMCP\u002Frun_unreal_mcp.bat\n\nYou can refer to this link for more info:\nhttps:\u002F\u002Fmodelcontextprotocol.io\u002Fquickstart\u002Fuser\n\nTo find the path to your claude for desktop install you can go into settings and click 'Edit Config'\nOn my Windows PC the path is:\nC:\\Users\\USERNAME\\AppData\\Roaming\\Claude\n\n## Usage\n### In Unreal Editor\nOnce the plugin is enabled, you'll find MCP controls in the editor toolbar button. \n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkvick-games_UnrealMCP_readme_c60bfb5e1caa.png)\n\n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkvick-games_UnrealMCP_readme_803d846dd705.png)\n\nThe TCP server can be started\u002Fstopped from here.\nCheck the output log under log filter LogMCP for extra information.\n\nOnce the server is confirmed up and running from the editor.\nOpen Claude for Desktop, ensure that the tools have successfully enabled, ask Claude to work in unreal.\n\nCurrently only basic operations are supported, creating objects, modfiying their transforms, getting scene info, and running python scripts.\nClaude makes a lot of errors with unreal python as I believe there aren't a ton of examples for it, but let it run and it will usually figure things out.\nI would really like to improve this aspect of how it works but it's low hanging fruit for adding functionality into unreal.\n\n### Client-Side Integration\nUse the provided Python scripts in the `MCP` directory to connect to and control your Unreal Engine instance:\n\n```python\nfrom unreal_mcp_client import UnrealMCPClient\n\n# Connect to the Unreal MCP server\nclient = UnrealMCPClient(\"localhost\", 13377)\n\n# Example: Create a cube in the scene\nclient.create_object(\n    class_name=\"StaticMeshActor\",\n    asset_path=\"\u002FEngine\u002FBasicShapes\u002FCube.Cube\",\n    location=(0, 0, 100),\n    rotation=(0, 0, 0),\n    scale=(1, 1, 1),\n    name=\"MCP_Cube\"\n)\n```\n\n## Command Reference\nThe plugin supports various commands for scene manipulation:\n- `get_scene_info`: Retrieve information about the current scene\n- `create_object`: Spawn a new object in the scene\n- `delete_object`: Remove an object from the scene\n- `modify_object`: Change properties of an existing object\n- `execute_python`: Run Python commands in Unreal's Python environment\n- And more to come...\n\nRefer to the documentation in the `Docs` directory for a complete command reference.\n\n## Security Considerations\n- The MCP server accepts connections from any client by default\n- Limit server exposure to localhost for development\n- Validate all incoming commands to prevent injection attacks\n\n## Troubleshooting\n- Ensure Unreal Engine is running with the MCP plugin.\n- Check logs in Claude for Desktop for stderr output.\n- Reach out on the discord, I just made it, but I will check it periodically\n  Discord (Dreamatron Studios): https:\u002F\u002Fdiscord.gg\u002FabRftdSe\n  \n### Project Structure\n- `Source\u002FUnrealMCP\u002F`: Core plugin implementation\n  - `Private\u002F`: Internal implementation files\n  - `Public\u002F`: Public header files\n- `Content\u002F`: Plugin assets\n- `MCP\u002F`: Python client scripts and examples\n- `Resources\u002F`: Icons and other resources\n\n## License\nMIT License\n\nCopyright (c) 2025 kvick\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and\u002For sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n## Credits\n- Created by: kvick\n- X: [@kvickart](https:\u002F\u002Fx.com\u002Fkvickart)\n  \n### Thank you to testers!!!\n- https:\u002F\u002Fgithub.com\u002FTheMurphinatur\n  \n- [@sidahuj](https:\u002F\u002Fx.com\u002Fsidahuj) for the inspriation\n\n\n\n## Contributing\nContributions are welcome, but I will need some time to wrap my head around things and cleanup first, lol\n","# UnrealMCP 插件\n\n\n[![Discord][discord-shield]][discord-url]\n\n[discord-shield]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=flat&logo=discord&logoColor=white\n[discord-url]: https:\u002F\u002Fdiscord.gg\u002FThkpVxdzet\n\n\n# 高度开发中 (WIP)\n我正在添加更多工具并清理代码库，\n我计划允许在主插件之外轻松扩展工具\n\n这仍然处于非常早期的开发阶段，我需要清理很多东西!!!!!\n\n另外，我只使用 Windows，所以我不知道这在 Mac\u002FUnix 上如何设置\n\n## 概述\nUnrealMCP 是一个非官方的虚幻引擎（Unreal Engine）插件，旨在通过 AI 工具控制虚幻引擎。它在虚幻引擎内实现了机器控制协议（Machine Control Protocol, MCP），允许外部 AI 系统与虚幻环境进行程序化交互和操控。\n\n我几天前才了解到 MCP，所以我还不太熟悉它，仍在学习中，因此初期可能比较粗糙。\n我是参考 https:\u002F\u002Fgithub.com\u002Fahujasid\u002Fblender-mcp 实现的，它依赖桌面版 Claude。它可能支持其他模型，也可能不支持，如果你进行了实验，请告诉我！\n\n## ⚠️ 免责声明\n此插件允许 AI 代理直接修改你的虚幻引擎项目。虽然它是一个强大的工具，但也存在风险：\n\n- AI 代理可能会对你的项目做出意外更改\n- 文件可能会被意外删除或修改\n- 项目设置可能会被更改\n- 资产可能会被覆盖\n\n**重要安全措施：**\n1. 始终与你的项目一起使用版本控制系统（如 Git 或 Perforce）\n2. 定期备份你的项目\n3. 首先在单独的项目中测试该插件\n4. 提交更改前请审查它们\n\n使用此插件即表示你确认：\n- 你对项目所做的任何更改负全责\n- 插件作者不对 AI 代理造成的任何损坏、数据丢失或问题负责\n- 你使用此插件的风险自负\n\n## 功能\n- 用于远程控制虚幻引擎的 TCP 服务器实现\n- 基于 JSON 的命令协议，用于 AI 工具集成\n- 编辑器 UI 集成，方便访问 MCP 功能\n- 全面的场景操作能力\n- 用于客户端交互的 Python 辅助脚本\n\n## 路线图\n这是我在 2025 年 3 月 14 日计划中的开发内容。\n我还不确定哪些是可行的，理论上什么都可以，但这取决于集成的 LLM（大语言模型）利用这些工具的能力有多好。\n- [X] 基本操作正常工作\n- [X] Python 正常工作\n- [X] 材质\n- [ ] 用户扩展（进行中）\n- [ ] 资产工具\n- [ ] 蓝图 (Blueprints)\n- [ ] Niagara 视觉效果 (VFX)\n- [ ] MetaSound\n- [ ] 地形 (Landscape)（我可能会暂时搁置这一点，因为 Epic 提到他们将更新地形工具）\n- [ ] 建模工具\n- [ ] 程序化内容生成 (PCG)\n\n## 要求\n- 虚幻引擎 5.5（我仅在此版本上测试过，可能在早期版本上也能工作，但没有官方支持）\n- 为虚幻引擎配置的 C++ 开发环境\n- Python 3.7+ 用于客户端脚本编写\n- 用于运行命令的模型，测试中我使用的是桌面版 Claude https:\u002F\u002Fclaude.ai\u002Fdownload\n\n## 安装\n1. 将此仓库克隆到你的虚幻项目的 `Plugins` 目录中：\n   ```\n   git clone https:\u002F\u002Fgithub.com\u002Fkvick-games\u002FUnrealMCP.git Plugins\u002FUnrealMCP\n   ```\n   项目路径应匹配以下模式：\n...\\UNREAL_PROJECT\\Plugins\\UnrealMCP\\\n\n3. 重新生成你的项目文件（右键点击 .uproject 文件并选择“生成 Visual Studio 项目文件”）\n4. 在你使用的任何 IDE 中构建项目，我使用 Rider，Visual Studio 也可以（正在制作发布版）\n5. 打开你的项目并在“编辑 > 插件 > UnrealMCP\"中启用该插件\n6. 在虚幻中启用 Python 插件\n7. 运行 setup_unreal_mcp.bat（随着更多人尝试，我可能需要对此文件进行一些修复）\n8. 目前我仅使用桌面版 Claude 进行了测试，因此请按照以下说明继续操作\n\n## 配合桌面版 Claude 使用\n你需要找到桌面版 Claude 的安装目录。找到 `claude_desktop_config.json` 并添加一个条目，使其看起来像这样：\n```json\n{\n    \"mcpServers\": {\n        \"unreal\": {\n            \"command\": \"C:\\\\UnrealMCP_Project\\\\Plugins\\\\UnrealMCP\\\\MCP\\\\run_unreal_mcp.bat\",\n            \"args\": []\n        }\n    }\n}\n```\n在命令字段中输入指向脚本的插件目录路径：\"run_unreal_mcp.bat\"\n此脚本位于 ..\u002Fplugin_root_directory\u002FMCP\u002Frun_unreal_mcp.bat 内\n\n你可以参考此链接获取更多信息：\nhttps:\u002F\u002Fmodelcontextprotocol.io\u002Fquickstart\u002Fuser\n\n要查找桌面版 Claude 的安装路径，你可以进入设置并点击“编辑配置”\n在我的 Windows PC 上，路径是：\nC:\\Users\\USERNAME\\AppData\\Roaming\\Claude\n\n## 用法\n### 在虚幻编辑器中\n启用插件后，你会在编辑器工具栏按钮中找到 MCP 控件。\n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkvick-games_UnrealMCP_readme_c60bfb5e1caa.png)\n\n![image](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkvick-games_UnrealMCP_readme_803d846dd705.png)\n\nTCP 服务器可以从这里启动\u002F停止。\n检查输出日志下的 LogMCP 过滤器以获取额外信息。\n\n一旦从编辑器确认服务器已启动并运行。\n打开桌面版 Claude，确保工具已成功启用，让 Claude 在虚幻中工作。\n\n目前仅支持基本操作，创建对象、修改它们的变换、获取场景信息和运行 Python 脚本。\n由于我认为虚幻 Python 方面的示例不多，Claude 在使用虚幻 Python 时经常出错，但让它运行通常能解决问题。\n我非常想改进这方面的工作方式，但这对于向虚幻添加功能来说是容易实现的功能点。\n\n### 客户端集成\n使用 `MCP` 目录中提供的 Python 脚本来连接和控制你的虚幻引擎实例：\n\n```python\nfrom unreal_mcp_client import UnrealMCPClient\n\n# 连接到虚幻 MCP 服务器\nclient = UnrealMCPClient(\"localhost\", 13377)\n\n# 示例：在场景中创建一个立方体\nclient.create_object(\n    class_name=\"StaticMeshActor\",\n    asset_path=\"\u002FEngine\u002FBasicShapes\u002FCube.Cube\",\n    location=(0, 0, 100),\n    rotation=(0, 0, 0),\n    scale=(1, 1, 1),\n    name=\"MCP_Cube\"\n)\n```\n\n## 命令参考\n插件支持各种场景操作命令：\n- `get_scene_info`: 检索当前场景的信息\n- `create_object`: 在场景中生成新对象\n- `delete_object`: 从场景中移除对象\n- `modify_object`: 更改现有对象的属性\n- `execute_python`: 在虚幻的 Python 环境中运行 Python 命令\n- 更多即将推出...\n\n有关完整的命令参考，请参阅 `Docs` 目录中的文档。\n\n## 安全考虑\n- MCP 服务器默认接受来自任何客户端的连接\n- 开发时将服务器暴露限制在本地主机 (localhost)\n- 验证所有传入的命令以防止注入攻击\n\n## 故障排除\n- 确保虚幻引擎 (Unreal Engine) 正在运行并加载了 MCP 插件。\n- 检查 Claude for Desktop 中的日志以查看 stderr (标准错误输出) 输出。\n- 在 Discord 上联系我，我刚刚创建了服务器，但我会定期检查\n  Discord (Dreamatron Studios): https:\u002F\u002Fdiscord.gg\u002FabRftdSe\n  \n### 项目结构\n- `Source\u002FUnrealMCP\u002F`: 核心插件实现\n  - `Private\u002F`: 内部实现文件\n  - `Public\u002F`: 公共头文件\n- `Content\u002F`: 插件资源\n- `MCP\u002F`: Python 客户端脚本和示例\n- `Resources\u002F`: 图标和其他资源\n\n## 许可证\nMIT 许可证\n\n版权所有 (c) 2025 kvick\n\n特此免费授予任何获得本软件副本及相关文档文件（“软件”）的人，在不加限制地使用、复制、修改、合并、出版、分发、再许可及\u002F或出售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：\n\n上述版权声明和本权限声明应包含在所有副本或软件的主要部分中。\n\n本软件按“原样”提供，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于对适销性、特定用途适用性和非侵权的保证。在任何情况下，作者或版权持有人均不对因使用本软件或在本软件的其他交易中使用本软件而产生的任何索赔、损害或其他责任负责，无论是在合同诉讼、侵权诉讼还是其他方面。\n\n## 致谢\n- 创建者：kvick\n- X: [@kvickart](https:\u002F\u002Fx.com\u002Fkvickart)\n  \n### 感谢测试人员！！！\n- https:\u002F\u002Fgithub.com\u002FTheMurphinatur\n  \n- [@sidahuj](https:\u002F\u002Fx.com\u002Fsidahuj) 提供的灵感\n\n\n\n## 贡献指南\n欢迎贡献，但我需要先花点时间理清思路并进行清理，哈哈","# UnrealMCP 快速上手指南\n\n**UnrealMCP** 是一个非官方的 Unreal Engine 插件，旨在通过机器控制协议（MCP）让外部 AI 系统直接控制并操作虚幻引擎。目前该工具处于早期开发阶段（WIP），仅官方测试支持 Windows 环境。\n\n> ⚠️ **重要风险提示**：此插件允许 AI 代理直接修改您的工程。可能导致资产丢失、设置更改或意外删除。**使用前请务必：**\n> 1. 启用版本控制（如 Git 或 Perforce）。\n> 2. 备份项目文件。\n> 3. 在独立项目中先行测试。\n> 4. 作者不对任何数据损失负责。\n\n## 环境准备\n\n*   **操作系统**：Windows（作者仅在此环境下测试，Mac\u002FUnix 未经验证）。\n*   **引擎版本**：Unreal Engine 5.5（可能兼容更早版本，但无官方支持）。\n*   **开发环境**：配置好的 C++ 开发环境（用于编译插件）。\n*   **脚本语言**：Python 3.7+（用于客户端交互）。\n*   **AI 模型**：推荐使用 **Claude for Desktop**（基于 README 测试环境）。\n\n## 安装步骤\n\n1.  **克隆插件**\n    将仓库克隆至您的 Unreal 项目的 `Plugins` 目录下：\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fkvick-games\u002FUnrealMCP.git Plugins\u002FUnrealMCP\n    ```\n    确保路径符合以下结构：\n    `...\\UNREAL_PROJECT\\Plugins\\UnrealMCP\\`\n\n2.  **生成项目文件**\n    右键点击 `.uproject` 文件，选择 **\"Generate Visual Studio project files\"**（生成 Visual Studio 项目文件）。\n\n3.  **编译项目**\n    在您使用的 IDE（如 Rider 或 Visual Studio）中构建项目。\n\n4.  **启用插件**\n    打开项目，进入 **Edit > Plugins**，搜索并启用 **UnrealMCP**。同时确保已启用 **Python** 相关插件。\n\n5.  **运行初始化脚本**\n    在项目根目录运行以下批处理文件：\n    ```bash\n    .\\setup_unreal_mcp.bat\n    ```\n\n6.  **配置 Claude 连接**\n    找到您的 Claude for Desktop 配置文件 `claude_desktop_config.json`（通常在 `C:\\Users\\USERNAME\\AppData\\Roaming\\Claude`），添加如下配置项，注意替换为您的实际插件路径：\n    ```json\n    {\n        \"mcpServers\": {\n            \"unreal\": {\n                \"command\": \"C:\\\\UnrealMCP_Project\\\\Plugins\\\\UnrealMCP\\\\MCP\\\\run_unreal_mcp.bat\",\n                \"args\": []\n            }\n        }\n    }\n    ```\n\n## 基本使用\n\n### 编辑器端操作\n1.  启动 Unreal Editor，在工具栏中找到 MCP 控制按钮。\n2.  点击按钮启动 TCP 服务器。\n3.  在输出日志窗口过滤 `LogMCP` 以查看服务器状态信息。\n\n### 与 AI 交互\n1.  打开 **Claude for Desktop**，确认工具已成功启用。\n2.  向 Claude 发送指令（例如：“在场景中创建一个立方体”）。\n3.  当前支持的基础功能包括：创建对象、修改变换、获取场景信息、运行 Python 脚本。\n\n### 客户端集成示例\n您也可以使用提供的 Python 脚本直接连接并控制引擎实例：\n\n```python\nfrom unreal_mcp_client import UnrealMCPClient\n\n# 连接到 Unreal MCP 服务器\nclient = UnrealMCPClient(\"localhost\", 13377)\n\n# 示例：在场景中创建一个立方体\nclient.create_object(\n    class_name=\"StaticMeshActor\",\n    asset_path=\"\u002FEngine\u002FBasicShapes\u002FCube.Cube\",\n    location=(0, 0, 100),\n    rotation=(0, 0, 0),\n    scale=(1, 1, 1),\n    name=\"MCP_Cube\"\n)\n```","独立游戏开发者在构建大型科幻场景时，需要根据剧情进度动态调整整个区域的灯光色温和植被材质，以营造特定的叙事氛围。这种需求在传统工作流中往往难以高效满足。\n\n### 没有 UnrealMCP 时\n- 需人工遍历数百个 Actor 手动修改参数，极易因疲劳导致数值错误。\n- 不同关卡间的光照一致性难以保证，视觉割裂感强，影响沉浸体验。\n- 每次微调都要重新编译或重启编辑器验证，流程卡顿严重消耗时间。\n- 复杂的多层材质嵌套关系让人手调变得几乎不可行，依赖资深美术经验。\n\n### 使用 UnrealMCP 后\n- UnrealMCP 允许 AI 代理直接扫描并批量更新指定区域的所有材质实例，消除人为疏漏。\n- 开发者只需输入“将主街道调整为冷色调”，即可自动执行脚本逻辑完成全局配置。\n- 结合 Python 脚本实现即时预览，无需等待漫长的渲染测试，迭代速度提升数倍。\n- 能够根据剧情状态动态调用 API 改变环境参数，实现真正的交互式关卡设计。\n\nUnrealMCP 将繁琐的手动操作转化为自然语言指令，显著提升了关卡编辑的自动化程度与灵活性。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkvick-games_UnrealMCP_c60bfb5e.png","kvick-games","kvick","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fkvick-games_516494ac.jpg","Game Developer, primarily a programmer but I do art too!\r\n\r\nwww.x.com\u002Fkvickart\r\nwww.artstation.com\u002Fkvick",null,"https:\u002F\u002Fgithub.com\u002Fkvick-games",[82,86,90,94],{"name":83,"color":84,"percentage":85},"C++","#f34b7d",61.7,{"name":87,"color":88,"percentage":89},"Python","#3572A5",35.6,{"name":91,"color":92,"percentage":93},"Batchfile","#C1F12E",2.2,{"name":95,"color":96,"percentage":97},"C#","#178600",0.5,557,73,"2026-04-02T08:36:03",4,"Windows","未说明",{"notes":105,"python":106,"dependencies":107},"仅明确测试支持 Windows，macOS\u002FUnix 兼容性未知；项目处于早期开发阶段（WIP），功能可能不稳定；AI 代理可直接修改工程文件及资产，务必开启版本控制（Git\u002FPerforce）并定期备份；需配置外部 AI 模型（如 Claude for Desktop）通过 MCP 协议交互；TCP 服务默认监听所有接口，建议仅限 localhost 访问以防安全风险。","3.7+",[108,109],"Unreal Engine 5.5","C++ 开发环境",[15,45],"2026-03-27T02:49:30.150509","2026-04-06T07:13:25.307916",[],[]]