Draw Things MCP Server

Draw Things アプリを活用して、Claude Desktop / Claude Codeから無料でローカル画像生成ができるMCPサーバーです。

Google Gemini、OpenAIなどの有料APIなしで、MacのApple Silicon（M1〜M4）で直接画像を生成します。

元リポジトリ: james-see/mcp-drawthings このリポジトリは、FLUX.1 Schnellモデル向けにデフォルト設定を最適化したバージョンです。

変更点（元リポジトリとの違い）

• デフォルトsteps: 20 → 4 — FLUX.1 Schnellモデルは4 stepsで十分な品質の画像を生成します。20〜30 stepsは不要に遅くなります。

---

必要要件

• macOS（Apple Silicon M1/M2/M3/M4）
• Draw Things アプリ（App Store）
• Node.js 18以上

---

ステップ1: Draw Thingsアプリのインストールと設定

1-1. アプリのインストール

App Storeで Draw Things を検索してインストールします。

1-2. 初期設定（モデルのダウンロード）

アプリを初めて起動すると、モデルソースの選択画面が表示されます。

ステップ	選択内容
ステップ 1/3: モデルソース	「Draw Things経由でモデルをダウンロード」 を選択
Cloud Compute	オフ（ローカル実行のみなので不要）
ステップ 2/3: モデル選択	検索欄に flux と入力 → 「FLUX.1 [schnell]」 を選択
ステップ 3/3: 保存先フォルダ	デフォルトまたは任意のフォルダを選択

補足: FLUX.1 [schnell] 通常版は約11.7GBです。Mac RAMが8GBの場合は5-bit版を選択してください。

ダウンロードが完了するまで待ちます。

1-3. APIサーバーを有効にする

1. 左サイドバーの 「設定」（歯車アイコン）をクリック
2. 上部タブの 「詳細」 をクリック
3. 「APIサーバー」 セクションを探す
4. 以下のように設定:

設定項目	値
サーバーオンライン	オン（緑色）
プロトコル	HTTP
ポート	7860（デフォルト）

設定後、ターミナルで確認:

curl http://localhost:7860

JSONレスポンスが返ってくれば成功です。

重要: Draw Thingsアプリは常に起動している必要があります。アプリを閉じるとAPIサーバーも停止します。最小化しておけばOKです。

---

ステップ2: MCPサーバーのインストール

git clone https://github.com/my13each/Drawthings_MCP.git
cd Drawthings_MCP
npm install
npm run build

---

ステップ3: MCPクライアントの設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加:

{
  "mcpServers": {
    "drawthings": {
      "command": "node",
      "args": ["/絶対パス/Drawthings_MCP/dist/index.js"]
    }
  }
}

設定後、Claude Desktopを再起動します。

Claude Code

claude mcp add --scope user drawthings -- node /絶対パス/Drawthings_MCP/dist/index.js

新しい会話を開始すると反映されます。

---

使い方

Claudeにこう言うだけです:

「宇宙でピザを食べるかわいい猫を描いて」

"Generate an image of a futuristic city at sunset"

英語のプロンプトの方が高品質な画像が生成されます。

---

MCPツール一覧

ツール	説明
check_status	Draw Things APIの接続状態を確認
get_config	現在ロードされているモデルと設定を取得
generate_image	テキストから画像を生成
transform_image	既存の画像をテキストプロンプトで変換

generate_image パラメータ

パラメータ	型	必須	説明
prompt	string	O	画像の説明テキスト
negative_prompt	string	X	除外する要素
width	number	X	画像の幅（デフォルト: 512）
height	number	X	画像の高さ（デフォルト: 512）
steps	number	X	推論ステップ数（デフォルト: 4）
cfg_scale	number	X	ガイダンススケール（デフォルト: 7.5）
seed	number	X	シード値（-1 = ランダム）
output_path	string	X	保存先パス

transform_image パラメータ

パラメータ	型	必須	説明
prompt	string	O	変換の説明テキスト
image_path	string	*	元画像のファイルパス
image_base64	string	*	Base64エンコードされた元画像
denoising_strength	number	X	変換強度 0.0〜1.0（デフォルト: 0.75）
steps	number	X	推論ステップ数（デフォルト: 4）

* image_path または image_base64 のどちらか必須

---

環境変数

変数	デフォルト	説明
DRAWTHINGS_HOST	localhost	APIサーバーのホスト
DRAWTHINGS_PORT	7860	APIサーバーのポート
DRAWTHINGS_OUTPUT_DIR	~/Pictures/drawthings-mcp	画像の保存ディレクトリ

---

アーキテクチャ

┌─────────────────┐     stdio      ┌──────────────────┐     HTTP      ┌─────────────┐
│   MCP Client    │◄──────────────►│  mcp-drawthings  │◄────────────►│ Draw Things │
│ (Claude/Cursor) │   JSON-RPC     │                  │  localhost    │    App      │
└─────────────────┘                └──────────────────┘   :7860       └─────────────┘
                                           │
                                           ▼
                                   ┌──────────────┐
                                   │  File System │
                                   │   (images)   │
                                   └──────────────┘

---

トラブルシューティング

「Draw Things APIに接続できません」

1. Draw Thingsアプリが起動中か確認
2. 設定で「サーバーオンライン」がオンになっているか確認
3. curl http://localhost:7860 でレスポンスを確認
4. アプリを閉じて再起動した場合、APIサーバーを再度オンにする必要がある場合があります

画像が生成されない

1. Draw Thingsにモデルがロードされているか確認
2. Draw Thingsアプリで直接画像生成をテスト
3. アプリのエラーメッセージを確認

---

ライセンス

MIT

クレジット

• 元リポジトリ: james-see/mcp-drawthings
• Draw Things - Mac/iOS AI画像生成アプリ
• Model Context Protocol - MCPプロトコル仕様