Draw Things MCP Cursor

🚀 繪製事物 MCP

本項目可使用模型上下文協議（MCP）將Draw Things API集成到Cursor中，為圖像生成提供便利，讓用戶能在Cursor環境下輕鬆生成所需圖像。

🚀 快速開始

要使用本項目，需要滿足一定的先決條件，完成安裝，並進行相應的集成設置。

✨ 主要特性

• 可將Draw Things API集成到Cursor中，方便在Cursor環境下使用。
• 支持多種參數設置，如圖像的寬高、生成步驟數、使用的模型等，滿足不同的圖像生成需求。
• 提供了清晰的響應格式，便於處理成功和錯誤情況。

📦 安裝指南

全局安裝

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": "your prompt here"}' | npx draw-things-mcp-cursor

高級用法

CLI中使用更多參數

echo '{
  "prompt": "a happy smiling dog, professional photography",
  "negative_prompt": "ugly, deformed, blurry",
  "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
}

🔧 技術細節

本項目使用模型上下文協議（MCP）將Draw Things API集成到Cursor中。當作為Cursor中的MCP工具使用時，工具會註冊為generateImage，並根據傳入的參數進行圖像生成。生成的圖像會以指定的文件名保存在images目錄中。同時，項目提供了清晰的響應格式，方便用戶處理成功和錯誤情況。

📄 許可證

本項目採用MIT許可證。

⚠️ 重要提示

遇到問題時，請確保Draw Things API在http://127.0.0.1:7888上運行；如果使用Cursor，請檢查~/.cursor目錄中的日誌文件；確保Node.js版本為>=14.0.0。