mcpField
K
Kokon

Kokon

本地服务
kokon.app媒体与设计230今天更新
代码仓库访问官网

关于 Kokon

Kokon 是一款 MCP 服务，可让 AI 编码工具通过本地 GPU 使用 Qwen-Image 2.1 生成和编辑图像。它依赖 Kokon 桌面应用，图像处理在本机完成。

主要功能

  1. 01离线生成图像
  2. 02使用参考图编辑图像
  3. 03局部重绘与扩图
  4. 04图像放大和元数据查询
  5. 05限制项目文件夹访问

适用场景

  1. 01制作项目和 README 配图
  2. 02按指令编辑截图
  3. 03修改或扩展图像指定区域

MCP 相关

向 MCP 客户端提供图像生成、编辑、检查和引擎状态工具。该服务将客户端连接到 Kokon 桌面应用及本地 GPU 引擎。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "gabrielelozupone-kokon": {
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ],
      "env": {
        "QLS_MCP_ALLOWED_DIRS": "<QLS_MCP_ALLOWED_DIRS>"
      }
    }
  }
}
启动命令npx -y kokon-mcp
需要配置的环境变量
QLS_MCP_ALLOWED_DIRSExtra folders the server may read and write, separated by semicolons. The project folder and Kokon's output folder are always allowed.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmkokon-mcp0.11.1

工具

8

收录的工具列表 · 更新于 2 天前

参数类型必填说明
seedinteger否用于获得可复现结果的种子；省略或设为 -1 可随机生成
widthinteger否输出宽度（像素，需同时指定高度）。省略时自动选择。
heightinteger否输出高度（像素，需同时指定宽度）。
promptstring是用自然语言描述要生成的内容
qualityenum否均使用 Qwen-Image 2.1 Turbo（8 步）：fast = 约 1 MP（默认，最快）；balanced = 约 1.5K；quality = 原生 2K（最慢；编辑时与参考图共用 2K）fast | balanced | quality
output_pathstring否可选的目标路径（绝对路径或相对于项目的路径）。必须位于项目目录或应用输出文件夹内。绝不覆盖现有文件；如有重名，将改用带编号的名称。
aspect_ratiostring否宽高比，例如 1:1、4:3、3:4、16:9、9:16 或 auto（根据提示推断）
include_previewboolean否同时在工具结果中返回较小的 JPEG 预览图。默认值为 false：图像保留在本地，不会发送给模型。

详细介绍

kokon-mcp

适用于 Kokon 的 MCP 服务。它让 Claude Code、Cursor、Claude Desktop 和其他 MCP 客户端能够使用 Qwen-Image 2.1 生成和编辑图像，并在你自己的 GPU 上离线运行。 无需 API 密钥，也无需云服务。所有内容都留在 127.0.0.1 上。

需要 Kokon 桌面应用（配备 12 GB 以上显存的 Windows 设备：NVIDIA，或处于测试阶段的 AMD/Intel； 或配备 16 GB 以上内存、处于测试阶段的 Apple Silicon Mac）。请从 kokon.app 下载，打开一次并 完成设置，以下载模型。此软件包只是 AI Agent 与应用之间的桥接程序。应用无需保持打开：服务会按需启动引擎。

设置

Claude Code：

claude mcp add --scope user kokon -- npx -y kokon-mcp

任何接受标准 JSON 配置（.mcp.json、Claude Desktop、Cursor 等）的客户端：

{
  "mcpServers": {
    "kokon": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kokon-mcp"]
    }
  }
}

需要 Node.js 22 或更高版本。如果不想使用 Node，Kokon 安装程序也会在应用中附带同一服务的独立可执行文件（kokon-mcp.exe / kokon-mcp）。请参阅 主 README。

然后提出请求：“为此 README 生成一张主视觉图片，并保存到 docs/”或“清除 screenshot.png 中杂乱的背景”。首次调用时，模型加载大约需要一分钟。

工具

MCP 会完全按照助手撰写的提示词执行：Kokon 自带的提示词撰写工具（Prompt+）不会在 MCP 中运行，因此由助手撰写完整描述。工具说明会告诉它该怎么做。

工具功能
generate_image文生图，可选择在新场景中使用最多 10 张参考图片（人物、产品、风格）。自动选择尺寸，也可设置宽度/高度或宽高比。
edit_image根据指令编辑图片。保持原尺寸；绝不覆盖输入文件。
edit_images在最多另外 9 张图片的辅助下编辑图片 1（“图片 1”、“图片 2”……）。
inpaint_image仅更改蒙版区域：编辑、移除、替换或添加内容。
outpaint_image将图片扩展至边界之外。
upscale_image放大图片（默认 2 倍，最高 8192 px）。
get_image_info图片尺寸、类型，以及 Kokon 图片的提示词、种子和设置。
get_generator_status引擎状态、GPU、VRAM 和任务队列。

行为与安全

  • 每个结果都会返回已保存文件的绝对路径、尺寸、种子和元数据。
  • 读取和写入仅限项目文件夹（CLAUDE_PROJECT_DIR 或工作目录）、Kokon 输出文件夹，以及 QLS_MCP_ALLOWED_DIRS 中列出的文件夹（以分号分隔）。绝不会覆盖现有文件。
  • 默认不会将图片发送回模型。设置 include_preview: true 可获取一张小尺寸 JPEG。
  • 通过 MCP 进度通知报告进度。

许可证

AGPL-3.0-only。应用下载的 Qwen-Image 2.1 模型权重遵循 Qwen Research License（非商业用途）。源码：github.com/GabrieleLozupone/kokon。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。