使用说明
🎛️ ComfyUI MCP管理器
版本： 0.0.5.0（阿尔法）
状态： ⚠️ Alpha软件-主动开发
一个功能强大的Electron系统托盘应用程序，通过模型上下文协议（MCP）管理ComfyUI，通过Claude Desktop实现自然语言工作流生成、全面的工作流管理、内存优化和高级监控功能。
🎯 主要特点
✅ 工作流管理系统
- 美丽的网格视图 -使用卡片和元数据浏览所有工作流
- 搜索和筛选 -按名称、描述、标签或类别查找工作流
- 收藏夹和模板 -标记重要工作流并标记可重用模板
- 导入/导出 -带有文件对话框的完整工作流导入/导出
- 元数据编辑 -编辑名称、描述、类别和标签
- 有组织的视图 -分别为“全部”、“收藏夹”（★）和“模板”选项卡(📋)
✅ 内存管理
- 存储统计 -数据库、日志和工作流的实时细分
- 清理工具 -一键清理旧执行和日志
- 数据库优化 -抽真空并优化SQLite数据库
- 备份和恢复 -完整的数据库导出/导入功能
✅ 实时仪表板
- 服务状态 -ComfyUI和MCP服务器的实时监控
- 服务控制 -从UI启动、停止、重新启动服务
- 系统度量 -CPU、内存、正常运行时间跟踪
- 自动刷新 -每5秒更新一次
✅ 过程和健康监测
- 进程信息 -查看ComfyUI进程详细信息（PID、CPU、内存）
- 控制台输出 -实时控制台输出（最后100行）
- 健康指标 -响应时间、CPU、内存、队列长度图表
- 历史数据 -随时间跟踪指标（20个数据点）
🔒 安全性（0.0.5.0中的新功能）
- 安全的API密钥存储 -存储在系统密钥链中的API密钥（Windows凭据管理器/macOS密钥链/Linux libsecret）
- 没有纯文本秘密 -已从config.json中删除API密钥
- 操作系统级加密 -由操作系统加密的密钥
- 蒙面显示器 -按键显示如下
****在UI中
✅ 系统集成
- Windows自动启动 -Windows启动时启动（注册表集成）
- 系统托盘 -带有所有控件的完整托盘菜单
- 通知 -本地系统通知
- 交叉平台的 -Windows、macOS、Linux支持
✅ ComfyUI自定义节点
- 配置管理器节点 -直接从ComfyUI工作流管理所有应用程序设置
- 读取/更新配置 -访问和修改配置
- 切换功能 -启用/禁用自动启动、自动启动
- 验证设置 -检查配置有效性
🎨 截图
工作流管理器
使用漂亮的卡片布局浏览、搜索、过滤工作流程
仪表盘
实时服务状态和控制
内存管理
存储统计和清理工具
📋 需求
- Node.js >=18.x
- python >=3.10（用于ComfyUI自定义节点）
- Comfy用户界面 -已安装且可访问
- API密钥 -用于工作流生成（安全存储）
🚀 安装
快速启动（开发）
# 1. Clone repository
git clone https://github.com/lazniak/comfy-mcp.git
cd comfy-mcp
# 2. Install dependencies
npm install
# 3. Build application
npm run build
# 4. Start application
npm start
首次启动设置
- 打开设置 从系统托盘图标
- 配置ComfyUI路径 （在大多数情况下自动检测）
- 输入API密钥 （安全地存储在系统钥匙链中）：
- API密钥
- N8N API密钥（如果使用）
- 保存设置
- 准备使用！
🔧 配置
安全配置
重要： 从0.0.5.0版本开始，API密钥为 不再存储在config.json中。它们安全地存储在系统的凭据管理器中：
- 视窗：Windows凭据管理器
- macOS：钥匙扣
- Linux：libsecret（GNOME密钥环/KWallet）
配置文件位置
%APPDATA%/comfy-mcp/config.json （Windows）
~/Library/Application Support/comfy-mcp/config.json （macOS）
~/.config/comfy-mcp/config.json （Linux）
配置示例
{
"app": {
"auto_start": true,
"start_minimized": true,
"notifications": true
},
"comfyui": {
"path": "A:/ComfyUI_NEW/ComfyUI",
"url": "http://127.0.0.1:8188",
"auto_launch": true,
"auto_restart": true,
"port_range": [8188, 8198],
"startup_timeout": 60,
"health_check_interval": 30
},
"mcp": {
"port": 3000,
"auto_launch": true,
"log_level": "info"
},
"claude": {
"model": "claude-3-5-sonnet-20241022",
"max_tokens": 8096
},
"n8n": {
"enabled": false,
"webhook_url": "http://localhost:5678"
},
"workflow": {
"template_cache_size": 15,
"storage_path": "./workflows/mcp-generated",
"result_size_threshold_mb": 5,
"auto_analyze": true
}
}
注： api_key 为了安全起见，将从配置中删除字段。
📖 用法
系统托盘菜单
右键单击托盘图标以访问：
- 仪表盘 -实时状态和控制
- 设置 -配置所有应用程序设置
- 工作流管理器 -浏览和管理工作流
- 内存管理 -存储统计和清理
- 进程信息 -ComfyUI流程详细信息
- 健康指标 -性能图表
- 关于 -申请信息
- 启动/停止服务 -控制ComfyUI和MCP
- 退出 -关闭应用程序
工作流管理
- 查看所有工作流 -带搜索和过滤器的网格视图
- 搜索 -按名称、描述或标签查找工作流
- 过滤器 -仅显示特定类别
- 排序 -按日期、用法或名称
- 收藏夹 -星形工作流程，便于快速访问（★）
- 模板 -标记可重用模式(📋)
- 编辑元数据 -单击任何工作流卡以编辑详细信息
- 导入 -从JSON文件添加工作流（支持多个）
- 出口 -将工作流保存到文件
内存管理
- 查看统计信息 -查看存储细分
- 清除旧数据 -删除旧执行（可配置保留）
- 清除日志 -删除旧日志文件
- 真空数据库 -优化SQLite数据库
- 导出数据库 -创建备份
- 导入数据库 -从备份还原
ComfyUI自定义节点
添加 ⚙️ MCP配置管理器 节点到您的工作流：
# Available in ComfyUI:
# Add Node → mcp → ⚙️ MCP Configuration Manager
# Features:
- Read current configuration
- Update any config section
- Toggle auto-start / auto-launch
- Reset to defaults
- Validate configuration
🔒 安全与隐私
安全凭证存储
所有敏感数据（API密钥、密码）都使用操作系统的安全凭据管理器存储：
- 静态加密 通过操作系统
- 从不以纯文本形式 文件
- 系统级保护
- 按用户隔离
访问存储的凭据
窗户：
- 打开控制面板
- 搜索“凭证管理器”
- 点击“Windows凭据”
- 寻找
ComfyUI-MCP-Manager/*条目
macOS：
- 打开“钥匙扣访问”应用程序
- 搜索
ComfyUI-MCP-Manager
Linux：
使用 seahorse （GNOME）或 kwalletmanager （KDE）
从旧版本迁移
如果从版本<0.0.5.0升级：
- 中的旧API密钥
config.json是 忽略 - 你必须 重新输入API密钥 在设置中
- 密钥将被安全地存储
- 可选：从中删除旧密钥
config.json手动地
看 API_KEYS_MIGRARATION_GUIDE.md 了解详情。
🏗️ 建筑
┌─────────────────────────────────────────────────┐
│ Electron Main Process │
│ ┌──────────────┐ ┌────────────────────────┐ │
│ │ Tray Manager │ │ Secure Credentials │ │
│ └──────────────┘ │ Service (keytar) │ │
│ ┌──────────────┐ └────────────────────────┘ │
│ │ Config Mgr │ ┌────────────────────────┐ │
│ └──────────────┘ │ MCP Server Manager │ │
│ ┌──────────────┐ └────────────────────────┘ │
│ │ ComfyUI │ ┌────────────────────────┐ │
│ │ Launcher │ │ Health Monitor │ │
│ └──────────────┘ └────────────────────────┘ │
│ ┌──────────────────────────────────────────┐ │
│ │ Database (SQLite) + Memory Manager │ │
│ └──────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
↕ IPC
┌─────────────────────────────────────────────────┐
│ Renderer Process (React UI) │
│ ┌──────────────┐ ┌────────────────────────┐ │
│ │ Dashboard │ │ Workflow Manager │ │
│ └──────────────┘ └────────────────────────┘ │
│ ┌──────────────┐ ┌────────────────────────┐ │
│ │ Memory Mgmt │ │ Process Info │ │
│ └──────────────┘ └────────────────────────┘ │
│ ┌──────────────┐ ┌────────────────────────┐ │
│ │ Settings │ │ Health Metrics │ │
│ └──────────────┘ └────────────────────────┘ │
└─────────────────────────────────────────────────┘
📚 文档
🛠️ 发展
构建命令
# Development mode with hot reload
npm run dev
# Build for production
npm run build
# Build TypeScript only
npm run build:electron
# Build React UI only
npm run build:ui
# Package for distribution
npm run package # All platforms
npm run package:win # Windows only
npm run package:mac # macOS only
npm run package:linux # Linux only
项目结构
comfy-mcp/
├── electron/ # Electron main process
│ ├── main.ts # Application entry point
│ ├── tray.ts # System tray manager
│ ├── mcp-manager.ts # MCP server manager
│ └── preload.ts # IPC bridge
├── src/ # MCP server & services
│ ├── services/ # Core services
│ │ ├── database.ts # SQLite database
│ │ ├── memory-manager.ts # Memory management
│ │ ├── secure-credentials.ts # Secure key storage
│ │ └── ...
│ └── index.ts # MCP server entry
├── ui/ # React frontend
│ └── src/
│ ├── App.tsx # Main app component
│ └── components/ # React components
│ ├── Dashboard.tsx
│ ├── WorkflowManager.tsx
│ ├── MemoryManagement.tsx
│ ├── ProcessInfo.tsx
│ └── HealthMetrics.tsx
├── python/ # ComfyUI custom node
│ ├── __init__.py
│ └── config_manager_node.py
└── assets/ # Icons and resources
📊 版本历史
0.0.5.0（2025年11月1日）-🔒 安全更新
- 突破性变化： API密钥移动到安全系统密钥链
- 添加
SecureCredentialsService使用keytar - 13个用于凭证管理的新IPC处理程序
- 修复了所有TypeScript编译错误
- 修复了运行时错误：
require is not defined - 从config.json接口中删除了API密钥
- 全面的文档更新
0.0.4.0（2025年11月1日）-全功能发布
- 完整的工作流管理系统
- 具有统计功能的内存管理
- 实时仪表板和监控
- 流程信息和健康指标查看器
- Windows自动启动支持
- 用于配置的ComfyUI自定义节点
- 漂亮的现代UI，1300多行CSS
- 42+IPC处理程序，20+数据库方法
0.0.3.0-API密钥和日志
- API密钥管理面板
- 带有过滤功能的日志查看器
- 所有设置的配置界面
0.0.2.0-核心集成
- ComfyUI启动器
- MCP服务器集成
- 健康监测
0.0.1.0-基础
- 初始项目结构
- Electron应用程序设置
- 基本UI框架
看 更改日志.md 完整的历史。
🤝 贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
🆘 支持
🎯 路线图
✅ 已完成（0.0.5.0）
- [x] 工作流管理系统
- [x] 内存优化工具
- [x] 实时仪表板
- [x] 过程和健康监测
- [x] 安全的API密钥存储
- [x] Windows自动启动
- [x] ComfyUI自定义节点
- [x] 漂亮的现代UI
🚧 进行中
- []克劳德桌面完全集成
- []工作流模板库
- []N8N集成
- []高级分析
📅 计划的
- []工作流缩略图
- []云同步（可选）
- []多语言支持
- []插件系统
🙏 致谢
- Comfy用户界面 -强大的基于节点的用户界面，实现稳定扩散
- Anthropic -用于AI驱动工作流生成的Claude API
- 模型上下文协议 -人工智能模型集成协议
- 电子 -跨平台桌面应用
- 反应 -UI框架
- 买家 -本机密码存储
由以下材料制成❤️ ComfyUI社区
星⭐ 如果你觉得这个仓库有用的话！
