内容
# 舒适飞行员 - 开放代码版
MCP 服务器，允许 OpenCode（或任何与 MCP 兼容的 AI 编码工具）直接控制 ComfyUI 进行 AI 图像生成。
> 从 [ConstantineB6/comfy-pilot](https://github.com/ConstantineB6/comfy-pilot) 分叉并适应 OpenCode 兼容性。
## 功能描述
不再手动点击 ComfyUI 中的节点，您只需告诉您的 AI 代理：
- “生成一个 1920x1080 的反乌托邦房间背景”
- “创建一个具有 3 种表情变体的角色精灵”
- “下载此模型并为其设置工作流”
代理使用 MCP 工具操纵您的 ComfyUI 工作流，设置提示并运行生成 - 所有这些都是程序化的。
## 功能
| 工具 | 描述 |
|---|---|
| `get_workflow` | 获取当前完整工作流 |
| `summarize_workflow` | 工作流总结（人类可读） |
| `get_node_types` | 搜索可用节点类型 |
| `get_node_info` | 获取节点的详细信息 |
| `get_status` | 队列状态和系统信息 |
| `run` | 运行工作流 / 中断 |
| `edit_graph` | 批量创建、删除、移动、连接节点 |
| `view_image` | 查看图像节点的输出 |
| `search_custom_nodes` | 搜索 ComfyUI 管理器注册表 |
| `install_custom_node` | 安装自定义节点 |
| `uninstall_custom_node` | 卸载自定义节点 |
| `update_custom_node` | 更新自定义节点 |
| `download_model` | 从 HF/CivitAI/URL 下载模型 |
## 快速入门
### 1. 安装依赖
```bash
pip install mcp httpx
```
### 2. 启动 ComfyUI
确保 ComfyUI 在 `http://localhost:8188` 上运行。
### 3. 配置 OpenCode
添加到 `~/.config/opencode/opencode.jsonc`：
```json
{
"mcp": {
"comfyui": {
"type": "local",
"command": ["python", "C:\\path\\to\\mcp_server.py"],
"enabled": true
}
}
}
```
或对于 Claude Code (`~/.claude/settings.json`)：
```json
{
"mcpServers": {
"comfyui": {
"command": "python",
"args": ["/path/to/mcp_server.py"]
}
}
}
```
### 4. 重启 AI 工具
重启 OpenCode 或 Claude Code 以获取新的 MCP 服务器。
### 5. 开始生成
连接后，您可以自然地说话：
```
“加载 Counterfeit 模型，设置提示为黑暗科幻房间，1920x1080，然后运行它。”
```
## 要求
- Python 3.8+
- ComfyUI（在 `localhost:8188` 上运行）
- 与 MCP 兼容的客户端（OpenCode、Claude Code 等）
## 工作原理
```
┌──────────────┐ stdio/MCP ┌──────────────┐ HTTP REST ┌──────────┐
│ OpenCode │ ◄──────────────────────►│ MCP 服务器 │ ◄────────────────────►│ ComfyUI │
│ （AI 代理） │ 命令/提示 │ （Python） │ localhost:8188 │ （服务器） │
└──────────────┘ └──────────────┘ └──────────┘
```
MCP 服务器将 AI 代理的自然语言命令转换为 ComfyUI API 调用，然后将结果流回。
## 许可证
MIT - 请参阅 [LICENSE](LICENSE)
## 鸣谢
原始项目： [ConstantineB6/comfy-pilot](https://github.com/ConstantineB6/comfy-pilot)
