Draw Things MCP

使用模型上下文协议 (MCP) 为 Cursor 集成的 Draw Things API。

前提条件

• Node.js >= 14.0.0
• Draw Things API 运行在 http://127.0.0.1:7888

安装

# 全局安装
npm install -g draw-things-mcp-cursor

# 或者直接运行
npx draw-things-mcp-cursor

Cursor 集成

要在 Cursor 中设置此工具，请参阅 cursor-setup.md 中的详细指南。

快速设置：

1. 创建或编辑 ~/.cursor/claude_desktop_config.json:

{
  "mcpServers": {
    "draw-things": {
      "command": "draw-things-mcp-cursor",
      "args": []
    }
  }
}

2. 重启 Cursor
3. 在 Cursor 中使用: generateImage({"prompt": "a cute cat"})

CLI 用法

生成图像

echo '{"prompt": "你的提示语"}' | npx draw-things-mcp-cursor

参数

• prompt: 用于图像生成的文本提示语 (必需)
• negative_prompt: 用于图像生成的负面提示语
• width: 图像宽度 (默认: 360)
• height: 图像高度 (默认: 360)
• steps: 生成步骤数 (默认: 8)
• model: 用于生成的模型 (默认: "flux_1_schnell_q5p.ckpt")
• sampler: 采样方法 (默认: "DPM++ 2M AYS")

示例:

echo '{
  "prompt": "一只快乐微笑的狗，专业摄影",
  "negative_prompt": "丑陋，畸形，模糊",
  "width": 360,
  "height": 360,
  "steps": 4
}' | npx draw-things-mcp-cursor

MCP 工具集成

当在 Cursor 中用作 MCP 工具时，该工具将被注册为 generateImage，并具有以下参数：

{
  prompt: string;       // 必需 - 用于生成图像的提示语
  negative_prompt?: string;  // 可选 - 负面提示语
  width?: number;       // 可选 - 图像宽度 (默认: 360)
  height?: number;      // 可选 - 图像高度 (默认: 360)
  model?: string;       // 可选 - 模型名称
  steps?: number;       // 可选 - 步骤数 (默认: 8)
}

生成的图像将保存在 images 目录中，文件名格式为： <sanitized_prompt>_<timestamp>.png

响应格式

成功:

{
  "type": "success",
  "content": [{
    "type": "image",
    "data": "base64 编码的图像数据",
    "mimeType": "image/png"
  }],
  "metadata": {
    "parameters": { ... }
  }
}

错误:

{
  "type": "error",
  "error": "错误信息",
  "code": 500
}

故障排除

如果您遇到问题：

• 确保 Draw Things API 正在 http://127.0.0.1:7888 运行
• 如果与 Cursor 一起使用，请检查 ~/.cursor/logs 中的日志文件
• 确保 src/index.js 具有执行权限：chmod +x src/index.js

许可证

MIT