Comfy MCP Server

Comfy MCP Server

site icon
2025.03.03 18
Python图像生成AI 服务内容生成
Comfy MCP Server 是一个基于 FastMCP 框架的服务器,用于通过远程 Comfy 服务器根据提示生成图像。它通过指定的工作流程与远程 Comfy 服务器交互,提交提示并获取生成的图像。
View on GitHub

Overview

基本能力

产品定位

Comfy MCP Server 是一个图像生成服务,通过 FastMCP 框架与远程 Comfy 服务器交互,实现基于提示的图像生成。

核心功能

  1. 图像生成:根据用户提供的提示生成图像。
  2. 提示生成:从指定主题生成详细的图像生成提示。
  3. 远程交互:与远程 Comfy 服务器交互,提交提示并获取生成的图像。
  4. 环境配置:支持通过环境变量配置 Comfy 服务器和工作流程。
  5. 多输出模式:支持将生成的图像输出为 URL 或文件。

适用场景

  1. 自动化图像生成:用于需要批量生成图像的场景。
  2. 创意设计:帮助设计师快速生成创意图像。
  3. AI 研究:用于研究和测试图像生成模型的工作流程。

工具列表

  1. uv:Python 的包和项目管理工具,用于安装和管理依赖。
  2. Ollama:可选工具,用于连接 LLM 模型生成提示。

常见问题解答

  1. 如何配置环境变量?:需要设置 COMFY_URLCOMFY_WORKFLOW_JSON_FILEPROMPT_NODE_IDOUTPUT_NODE_IDOUTPUT_MODE 等环境变量。
  2. 如何启动服务器?:使用命令 uvx comfy-mcp-server 启动服务器。
  3. 如何生成图像?:调用 generate_image 函数并传入提示文本。

使用教程

使用依赖

  1. 安装 uv 包管理工具: bash uvx mcp[cli]

安装教程

  1. 安装依赖包: bash uvx mcp[cli]
  2. 配置环境变量: bash export COMFY_URL=http://your-comfy-server-url:port export COMFY_WORKFLOW_JSON_FILE=/path/to/the/comfyui_workflow_export.json export PROMPT_NODE_ID=6 export OUTPUT_NODE_ID=9 export OUTPUT_MODE=file
  3. 启动服务器: bash uvx comfy-mcp-server

调试方式

  1. 检查环境变量是否设置正确: bash echo $COMFY_URL echo $COMFY_WORKFLOW_JSON_FILE
  2. 启动服务器并查看日志: bash uvx comfy-mcp-server
  3. 调用生成图像函数并检查输出: python generate_image("test prompt", ctx)

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。