ketchup-draw-mcp-server

Komorebi-yaodong/ketchup-draw-mcp-server

3.1

If you are the rightful owner of ketchup-draw-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Ketchup Draw MCP Server integrates Ketchup AI's drawing capabilities with Catbox image hosting service, allowing MCP clients to generate and share images easily.

Ketchup Draw MCP Server

npm version License: MIT

这是一个 MCP (Model Context Protocol) 服务器，集成了 Ketchup AI 的专业绘图能力和 URUSAI! 的图床服务。

它可以让 Claude Desktop 等 MCP 客户端具备“画图”能力：不仅仅是生成图片，还能自动优化提示词，并将生成的图片自动上传至云端，返回可永久访问的 URL。

Demo

✨ 特性

  • 智能提示词优化 (Prompt Engineering): 将简单的中文/英文短语（如“一只可爱的狗”）自动改写为包含光影、风格、细节描述的专业绘图提示词。
  • 高质量绘图 (AI Generation): 调用 Ketchup AI 引擎生成高分辨率图像。
  • 自动图床上传 (Auto Upload): 生成的图片会自动上传至 URUSAI!，并在对话中直接展示图片预览，同时提供永久链接。
  • 代理支持 (Proxy Support): 内置 undici 代理配置，完美解决国内网络环境下无法访问 URUSAI! 或 API 的问题。

🧰 工具详情 (Tools)

本服务器向 MCP 客户端暴露了以下两个工具，大模型可根据上下文自动调用：

1. optimize_prompt

用于将用户的简短描述转化为专业的英文绘图提示词。

  • 描述: Optimize a simple drawing prompt into a detailed professional prompt using Ketchup AI.
  • 输入参数 (Input Schema):
参数名类型必填说明
promptstring✅需要优化的原始提示词（例如："cyberpunk city at night" 或 "赛博朋克城市"）

2. generate_image

用于执行实际的绘图操作并上传。

  • 描述: Generate an image using Ketchup AI and upload it to URUSAI!. Returns the image URL.
  • 输入参数 (Input Schema):
参数名类型必填说明
promptstring✅详细的绘图提示词（建议先调用 optimize_prompt 获取）
ratiostring✅图片比例，必须是下方列表中的值之一（如 "16x9"）
📐 支持的图片比例 (ratio)

在调用 generate_image 时，ratio 参数支持以下枚举值：

比例代码尺寸 (WxH)适用场景
1x11024 x 1024头像、Instagram
16x91344 x 768壁纸、视频封面
9x16768 x 1344手机壁纸、Stories
4x31152 x 896传统照片
3x4896 x 1152肖像
21x91536 x 640电影宽银幕
9x21640 x 1536长条幅
3x21280 x 832风景
2x3832 x 1280海报

🚀 使用方法 (Claude Desktop)

无需克隆代码，直接修改 Claude Desktop 的配置文件即可使用 npx 运行。

1. 找到配置文件

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加配置

将以下内容添加到 mcpServers 对象中：

{
  "mcpServers": {
    "ketchup-draw": {
      "command": "npx",
      "args": [
        "-y",
        "ketchup-draw-mcp-server"
      ],
      "env": {
        "HTTPS_PROXY": "http://127.0.0.1:7890"
      }
    }
  }
}

⚠️ 网络配置重要提示： 由于 URUSAI! 和 Ketchup AI 的服务器在海外，如果你在中国大陆，必须配置 env 中的 HTTPS_PROXY。

  • 请将 127.0.0.1:7890 替换为你本地代理软件（如 Clash, v2rayN 等）的实际 HTTP 端口。
  • 如果没有配置代理，图片上传大概率会失败。

🛠️ 本地开发

如果你想贡献代码或进行本地调试：

# 1. 克隆仓库
git clone https://github.com/Komorebi-yaodong/ketchup-draw-mcp-server.git
cd ketchup-draw-mcp-server

# 2. 安装依赖
pnpm install

# 3. 编译
pnpm build

# 4. 运行
node dist/index.js

License

MIT