舒适UI-MCP
项目介绍
ComfyUI MCP Server - 生产环境
一个强大的模型上下文协议（MCP）服务器，通过ComfyUI为Unity提供可靠的AI图像生成服务。
功能
🎨 可靠的图像生成
- 基于队列的完成检测（无超时）
- 多种下载备用方法
- 生产级错误处理
🌸 专业工作流程
- 可定制参数的一般图像生成
- 优化用于Unity的花卉纹理生成
- 支持无缝平铺纹理
🔧 生产就绪
- 全面的日志记录和监控
- 使用环境变量进行配置管理
- 强大的错误处理和恢复机制
- 性能统计和健康监测
🎮 Unity集成
- 自动管理Unity资产文件夹
- PNG纹理优化
- 材料准备输出格式
快速开始
预备条件
- 在
http://127.0.0.1:8188运行的ComfyUI - 安装了所需包的Python 3.8+
- 具有Assets文件夹结构的Unity项目
安装
-
安装依赖项：
pip install mcp requests -
配置MCP客户端以使用此服务器：
{ "mcpServers": { "comfy": { "command": "python", "args": ["path/to/comfyui-mcp/server.py"], "cwd": "path/to/comfyui-mcp" } } } -
通过Unity/Coplay开始使用！
使用
生成一般图像
# 通过MCP客户端
result = await mcp_client.call_tool("generate_image", {
"client_id": "unity-client",
"prompt": "美丽的风景，日落，高质量",
"width": 1024,
"height": 1024,
"steps": 25,
"cfg": 7.5
})
生成花卉纹理
# 通过MCP客户端
result = await mcp_client.call_tool("generate_flower_texture", {
"client_id": "unity-client",
"flower_type": "rose",
"seamless": True,
"detail_level": "high"
})
检查服务器状态
# 获取服务器健康状况和统计数据
status = await mcp_client.call_tool("get_server_status", {
"client_id": "unity-client"
})
配置
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
COMFYUI_HOST | 127.0.0.1 | ComfyUI服务器主机 |
COMFYUI_PORT | 8188 | ComfyUI服务器端口 |
UNITY_TEXTURE_PATH | Assets/Textures/Generated | Unity纹理输出路径 |
UNITY_MATERIAL_PATH | Assets/Materials | Unity材质路径 |
GENERATION_TIMEOUT | 180 | 生成的最大等待时间（秒） |
REQUEST_TIMEOUT | 30 | HTTP请求超时时间（秒） |
QUEUE_CHECK_INTERVAL | 3 | 队列轮询间隔（秒） |
DEFAULT_WIDTH | 512 | 默认图像宽度 |
DEFAULT_HEIGHT | 512 | 默认图像高度 |
DEFAULT_STEPS | 25 | 默认采样步骤数 |
DEFAULT_CFG | 7.5 | 默认CFG比例 |
DEFAULT_MODEL | v1-5-pruned-emaonly.ckpt | 默认ComfyUI模型 |
LOG_LEVEL | INFO | 日志级别（DEBUG, INFO, WARNING, ERROR） |
COMFYUI_MCP_MODE | production | 模式（production, development） |
示例配置
# 生产设置
export COMFYUI_HOST="192.168.1.100"
export COMFYUI_PORT="8188"
export GENERATION_TIMEOUT="300"
export LOG_LEVEL="INFO"
# 开发设置
export COMFYUI_MCP_MODE="development"
export LOG_LEVEL="DEBUG"
export GENERATION_TIMEOUT="60"
架构
核心组件
- ComfyUIClient - 处理所有与ComfyUI的通信
- WorkflowGenerator - 为不同用例创建ComfyUI工作流
- FileManager - 管理Unity资产文件操作
- ImageGenerationService - 高级生成编排
- MCP Server - 处理模型上下文协议通信
基于队列的完成检测
服务器使用ComfyUI的队列API来可靠地检测完成情况：
- 将工作流提交到ComfyUI队列
- 监控队列状态（待处理 → 运行中 → 已完成）
- 当提示从队列消失时，从历史记录中获取结果
- 下载并保存生成的图像
这种方法消除了超时问题，并提供了可靠的完成检测。
多种下载备用方法
图像使用多种备用方法下载：
- 标准方法：
/view?filename=X&subfolder=Y&type=Z - 直接方法：
/view?filename=X - 仅类型方法：
/view?filename=X&type=output
这确保了与不同的ComfyUI配置兼容性。
监控与调试
生产日志
服务器提供全面的日志记录：
2025-01-24 14:21:35,123 - comfyui-mcp - INFO - 已排队提示abc123: 美丽的风景...
2025-01-24 14:21:45,456 - comfyui-mcp - INFO - 提示abc123已完成
2025-01-24 14:21:46,789 - comfyui-mcp - INFO - 已保存图像：Assets/Textures/Generated/generated_1024x1024_2025-01-24_14-21-46.png (1234567字节)
服务器统计
服务器跟踪性能指标：
- 处理的总请求数
- 成功与失败的生成次数
- 服务器运行时间
- ComfyUI连接状态
通过get_server_status工具访问。
错误处理
服务器提供详细的错误信息：
- ComfyUI连接问题
- 工作流提交失败
- 图像下载问题
- 文件系统错误
所有错误都包括上下文和建议解决方案。
性能提示
ComfyUI优化
- 使用适当的模型 - 较轻的模型生成速度更快
- 优化步骤 - 较少的步骤 = 更快的生成
- 批处理 - 排队多个请求
- 模型缓存 - 在ComfyUI中加载模型
Unity集成
- 纹理压缩 - 在Unity中启用适当的压缩
- Mipmaps - 对于无缝纹理启用
- 纹理流 - 对于大型纹理
- 资产数据库刷新 - 自动发生
故障排除
常见问题
“ComfyUI未运行”
- 检查ComfyUI是否已启动并在配置的URL上可访问
- 验证防火墙/网络设置
- 检查ComfyUI控制台中的错误
“生成超时”
- 增加
GENERATION_TIMEOUT环境变量 - 检查ComfyUI队列中的卡住任务
- 验证模型是否在ComfyUI中加载
“输出中找不到图像”
- 检查ComfyUI工作流兼容性
- 验证模型存在且已加载
- 检查ComfyUI控制台中的工作流错误
“无法保存到Unity文件夹”
- 检查Unity项目是否打开
- 验证对Assets文件夹的写入权限
- 检查磁盘空间可用性
调试模式
启用调试日志：
export COMFYUI_MCP_MODE="development"
export LOG_LEVEL="DEBUG"
这提供了关于以下方面的详细信息：
- 队列监控
- 图像下载尝试
- 文件操作
- 错误详情
版本历史
- v1.0.0 - 带有基于队列检测的生产发布
- v0.9.x - 解决超时问题的开发版本
- v0.8.x - 初始MCP服务器实现
社区与协作
加入我们的Discord社区进行合作、获取帮助并分享您的项目：
在我们的Discord服务器中，您可以：
- 获取有关ComfyUI MCP集成的帮助
- 分享您生成的图像和工作流
- 合作开发新特性和改进
- 与其他Unity AI开发者联系
- 了解最新发展
支持
对于问题和疑问：
- 查看上面的故障排除部分
- 启用调试日志以获取详细信息
- 检查ComfyUI服务器日志
- 验证Unity项目的设置
- 加入我们的Discord社区以获得实时帮助
许可
此ComfyUI MCP服务器是Coplay AI开发工具包的一部分。