使用说明

项目简介

ComfyUI MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，它充当 LLM 客户端和本地 ComfyUI 图像生成工具之间的桥梁。通过该服务器，LLM 应用可以利用 MCP 协议标准化的方式，安全、可扩展地调用 ComfyUI 的强大图像生成能力。

主要功能点

图像生成工具 (generate_image): 允许 LLM 客户端通过指定文本提示词，调用 ComfyUI 生成图像。支持配置正面和负面提示词、种子、图像尺寸等参数。
笔记资源 (notes): 提供简单的笔记存储功能，允许创建、访问和管理文本笔记。
Prompt模板 (summarize-notes): 提供一个 Prompt 模板，用于总结所有已存储的笔记内容，可以控制总结的详细程度。
添加笔记工具 (add-note): 允许 LLM 客户端向服务器添加新的文本笔记。
资源变更通知: 当笔记资源发生变化（例如添加新笔记）时，服务器会通知已连接的客户端。

安装步骤

环境准备: 确保您的系统已安装 Python 环境。建议使用 Python 3.8 或更高版本。
下载仓库: 从 GitHub 仓库 https://github.com/jonpojonpo/comfy-ui-mcp-server 下载代码到本地。
安装依赖: 在仓库根目录下，打开终端或命令提示符，运行以下命令安装项目依赖：
```
uv sync
```
启动服务器: 在仓库根目录下，运行以下命令启动 MCP 服务器：
```
uv run src/comfy_ui_mcp_server
```
或者直接运行 'python -m src.comfy_ui_mcp_server.server'

服务器配置

对于 MCP 客户端（例如 Claude Desktop），您需要配置 MCP 服务器的启动命令和参数。以下是针对 'comfy-ui-mcp-server' 的配置示例，您可以将其添加到 MCP 客户端的配置文件中。

Claude Desktop 配置示例 (claude_desktop_config.json):

"mcpServers": {
  "comfy-ui-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "您的comfy-ui-mcp-server仓库路径",  //  请替换为您的 comfy-ui-mcp-server 仓库在本地的绝对路径，例如 "E:\\Claude\\comfy-ui-mcp-server" 或 "~/Claude/comfy-ui-mcp-server"
      "run",
      "src/comfy_ui_mcp_server" //  执行服务器启动脚本
    ]
  }
}

配置参数说明:

'"comfy-ui-mcp-server"': 服务器名称，客户端用此名称识别和连接服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' (假设您已安装 'uv'，也可以使用 'python')。
'"args"': 命令参数列表。
- '"--directory", "您的comfy-ui-mcp-server仓库路径"': 指定 'uv' 命令的工作目录为您的仓库路径。
- '"run"': 'uv' 命令的子命令，用于运行 Python 模块或脚本。
- '"src/comfy_ui_mcp_server"': 指定要运行的 Python 模块，指向服务器启动脚本 'server.py'。

注意: 请根据您的实际环境修改 '"您的comfy-ui-mcp-server仓库路径"' 为正确的本地仓库路径。

基本使用方法

启动 ComfyUI: 确保您的 ComfyUI 已经启动并运行，默认地址为 '127.0.0.1:8188'。您可以通过设置环境变量 'COMFY_SERVER' 来修改 ComfyUI 服务器地址。
配置 MCP 客户端: 根据上述 "服务器配置" 部分，配置您的 MCP 客户端（如 Claude Desktop）以连接到 'comfy-ui-mcp-server'。
使用 LLM 客户端: 在支持 MCP 的 LLM 客户端中，您应该能够发现 'comfy-ui-mcp-server' 提供的功能。
- 图像生成: 使用 "generate_image" 工具，输入文本提示词，即可调用 ComfyUI 生成图像，并将图像返回给 LLM 客户端。
- 笔记管理: 可以使用 "add-note" 工具添加笔记，并使用 "summarize-notes" Prompt 模板总结笔记内容。

通过以上步骤，您就可以利用 ComfyUI MCP Server，在 LLM 应用中集成 ComfyUI 的图像生成能力，并使用简单的笔记管理功能。

关键词