recraft-mcp-server

🎨 Recraft MCP Server

AI アシスタント（Claude、Gemini、または任意の MCP クライアント）に、Recraft AI の画像生成 API への直接アクセスを提供する Model Context Protocol (MCP) サーバーです。チャットから離れることなく、画像の生成、変換、高解像度化、ベクター化を行えます。

「同じアートスタイルでファンタジーゲーム用のアイコンを8個生成してください。」 「このスクリーンショットの背景を削除して、高解像度化してください。」 「このロゴのスタイル違いを5種類作成し、比較用のグリッドに並べてください。」

公式サーバーから移行する場合

Recraft は2026年7月に @recraft-ai/mcp-recraft-server をアーカイブし、現在はホスト型エンドポイント https://mcp.recraft.ai/mcp を案内しています。どちらを選ぶかは、用途によって異なります。

	Recraft のホスト型	このサーバー
セットアップ	ブラウザーで OAuth、API キー不要	npm install + API キー
ツール	9	28
料金	サブスクリプションのクレジット	API ユニット。各ツールで呼び出しコストを確認できます
ローカルファイル	不可 — URL と base64 のみ	マシン上のファイルを読み書きできます
バッチ処理／パイプライン	不可	生成 → ダウンロード → 背景削除 → 保存、テーマ別セット、比較用グリッド
スタイル管理	作成のみ	作成、一覧表示、詳細確認、削除

画像をたまに生成するだけなら、ホスト型サーバーのほうが手間が少なく、このサーバーを選ぶ利点はありません。アセットをまとめて作成する場合、ディスク上のファイルを使う場合、または実行前に処理コストを把握する必要がある場合に、このサーバーが役立ちます。

ツール名の対応

注記があるものを除き、旧名称に recraft_ のプレフィックスを付けています。

公式（アーカイブ済み）	こちら
generate_image	recraft_generate_image
image_to_image	recraft_image_to_image
remove_background	recraft_remove_background
replace_background	recraft_replace_background
crisp_upscale	recraft_crisp_upscale
creative_upscale	recraft_creative_upscale
create_style	recraft_create_style
vectorize_image	recraft_vectorize
get_user	recraft_check_credits

知っておくべき動作上の違いが1つあります。Recraft の style フィールドで指定できるのは6つの大まかなスタイル群で、具体的なルック（pixel_art、kawaii、b_and_w など）は別の substyle フィールドで指定します。style にサブスタイル名を渡しても、API では無視されます。このサーバーはどちらの指定も受け付け、適切に振り分けるため、旧サーバー向けに書かれたプロンプトも引き続き動作します。

🌟 主な機能

• 🖼️ すべての Recraft モデル（V4.1、V4 Styles、V4、V4 Vector/SVG、V4 Pro、V3、V2）でのテキストから画像を生成。スタイルの分類体系全体（6 ファミリー × 104 サブスタイル）を網羅しており、手作業で書き起こすのではなく、Recraft 独自の API 仕様から生成しています。
• 🔁 画像変換 — 画像から画像への変換、インペイント、背景の置換・生成、アウトペイント（キャンバスの拡張）、バリエーションの生成
• ✨ 高品質化 — 背景の削除、ベクター化、クリスプ／クリエイティブアップスケール、領域の消去
• 🔎 探索 — 自由形式での探索用画像生成、「これに似た画像をもっと」、プロンプトの自動強化
• 🧩 アセットのパイプライン — 生成 → ダウンロード → 背景削除 → 保存を 1 回の呼び出しで実行、バッチ生成、スタイルの一貫性を保ったテーマ別アセットセット
• 🎮 ゲーム開発向けの追加機能 — スプライト／アイコン向けのサイズ指定生成、スタイル比較グリッド、テクスチャ／アトラスの差し替え
• 👁️ エージェントは生成した画像を確認できます — 生成結果には URL とともにインラインプレビューが含まれ、コンテキストの予算に収まるよう縮小されます。これがない場合、モデルは 4 つのバリエーションを生成しても、どれも評価できません。
• 💰 すべての呼び出しで料金を報告します — Recraft は各操作のクレジットコストを提示し、この MCP サーバーはその情報をそのまま返すため、エージェントはバッチ実行前に、4 クレジットのクリスプアップスケールと 250 クレジットのクリエイティブアップスケールを見分けられます。
• 🎨 スタイル管理 — カスタムスタイルを作成し、一覧表示、確認、削除できます。

🛠️ 提供するツール

この MCP サーバーは 28 個のツールを AI エージェントに提供し、Recraft API を全面的にカバーします。

生成

ツール	説明
recraft_generate_image	すべての Recraft モデルでテキストから画像を生成します。70 種類以上のスタイル、色やテキストレイアウトの調整に対応します。
recraft_generate_sized	任意の目標サイズ（最小 64×64）で生成します。スプライト／アイコン／UI に最適です。
recraft_batch_generate	複数のアセットをパイプライン全体とともに順次生成します。アセットごとの失敗にも柔軟に対応します。
recraft_generate_themed_set	メインのアセット、対応するスタイル、および残りすべてのシンボルを、視覚的な一貫性を保って生成します。
recraft_compare_styles	オプションで並べて比較するグリッドを作成し、複数のスタイルで同じプロンプトを生成します。

探索

ツール	説明
recraft_explore	プロンプトを自由形式で探索するため、多様な画像セットを生成します。
recraft_explore_similar	以前の recraft_explore の結果に視覚的に似た画像をさらに生成します。
recraft_enhance_prompt	短いプロンプトを、より豊かで詳細なプロンプトに展開します。

変換

ツール	説明
recraft_image_to_image	テキストプロンプトを使って既存の画像を変換します（強度を調整可能）。
recraft_inpaint	画像のマスクされた領域を再生成します。
recraft_replace_background	被写体を維持しながら、AI で新しい背景を生成します。
recraft_generate_background	既存のキャンバス内のマスクされた背景領域を塗りつぶします。
recraft_outpaint	AI 生成コンテンツを使って、画像の元の境界を越えてキャンバスを拡張します。
recraft_variate_image	既存の画像のバリエーションを生成します。
recraft_texture_swap	領域を新しい AI コンテンツで置き換えます。Spine のアトラス／スプライトシートの差し替え向けに作られています。

高品質化

ツール	説明
recraft_remove_background	透明な PNG にするために背景を削除します。
recraft_vectorize	ラスター画像（PNG/JPG/WEBP）→ SVG
recraft_crisp_upscale	グラフィック、アイコン、イラスト向けのクリーンなアップスケール
recraft_creative_upscale	写真向けに顔を補正しながら、AI でディテールを追加してアップスケールします。
recraft_erase_region	マスクされた領域をコンテンツに応じて削除します。

スタイル管理

ツール	機能
recraft_create_style	1～5 枚の参照画像からカスタムスタイルを作成します。
recraft_list_styles	アカウント上のカスタムスタイルを一覧表示します。無料で、読み取り専用です。
recraft_get_style	ID でスタイルを検索します。無料で、読み取り専用です。
recraft_delete_style	スタイルを完全に削除します。
recraft_list_basic_styles	Recraft の組み込みスタイルをモデルごとに API からリアルタイムで取得します。

アセットとアカウント

ツール	説明
recraft_create_style	1～5 枚の参照画像から、再利用可能なカスタムスタイルを作成します
recraft_generate_asset	一連の処理を実行します：生成 → ダウンロード → 必要に応じて背景を削除 → ファイルに保存
recraft_download_image	画像 URL をローカルファイルに保存します
recraft_check_credits	アカウント情報と残りの API クレジットを確認します

プレビューとコスト

エージェントができることに影響するため、知っておくとよい動作が 2 つあります。

プレビュー。 生成ツールは URL とともに小さなインライン画像を返すため、モデルは結果を実際に確認できます。4 つのバリエーションから最適なものを選んだり、背景の削除でハローが残ったことに気づいたり、テキストが文字化けしたことを確認したりできます。プレビューはコンテキストの予算に収まるまで縮小され（WebP、最長辺 ≤768px、base64 は ≤700KB）、1 回の呼び出しにつき最大 4 件に制限されます。上限のない base64 データは、画像の価値を上回るコンテキストを消費するためです。

画像の評価を行わない場合は、呼び出しごとに無効にできます。

recraft_generate_image(prompt: "...", preview: false)

コスト。 Recraft の応答には、その呼び出しにかかったクレジット数が必ず記載され、ここにあるすべてのツールがその情報を引き継ぎます。

Model: recraftv4 | Size: 1024x1024 | Substyle: kawaii | Cost: 40 credits

これは想像以上に重要です。クリエイティブアップスケールは 250 クレジットかかるのに対し、クリスプアップスケールは 4 クレジットで、62 倍の差があります。また、テーマに沿った 12 個のシンボルセットには約 600 クレジットかかります。recraft_check_credits で残高を確認でき、スタイル管理ツールは読み取り無料なので、エージェントはクレジットを使う前に確認できます。

⚙️ クイックスタート

Node.js 20.9.0 以降が必要です。バージョン 1.1.0 では、既知の libvips の脆弱性に対処するため、画像処理のネイティブ依存関係が更新されました。Node.js 18 はサポート対象外になりました。

1. Recraft API キーを取得する

recraft.ai に登録し、アカウント設定から API キーを取得してください。

2. インストールして設定する

claude mcp add --scope user recraft \
  -e RECRAFT_API_KEY=your-api-key-here \
  -- npx -y recraft-mcp-server

または、MCP クライアントの設定に手動で追加します。

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp-server"],
      "env": {
        "RECRAFT_API_KEY": "your-api-key-here"
      }
    }
  }
}

環境変数

変数	説明
RECRAFT_API_KEY	Recraft AI API キー

Docker

docker build -t recraft-mcp-server .
docker run -i --rm -e RECRAFT_API_KEY=your-key recraft-mcp-server

MCP クライアントの設定では、次のようにします。

{
  "mcpServers": {
    "recraft": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECRAFT_API_KEY", "recraft-mcp-server"],
      "env": { "RECRAFT_API_KEY": "your-key" }
    }
  }
}

コンテナは stdio 経由で MCP と通信し、ポートを開かないため、-i は必須ですが、-p は不要です。特権のないユーザーとして実行されるため、ファイルを書き込むツールでは対象ディレクトリをバインドマウントする必要があります（-v /path:/path）。

🤖 AI プロンプトの例

ゲームアセットのパイプライン：

「同じスタイルでファンタジーのポーションアイコンを 6 個作成し、Pixi.js のマニフェストとしてエクスポートしてください。」 → recraft_generate_themed_set

スプライトのクイック生成：

「64x64 のピクセルアートのコインアイコンを生成してください。」 → recraft_generate_sized

スタイルの検討：

「このロゴのプロンプトを 4 種類の異なるスタイルで並べて見せてください。」 → recraft_compare_styles

写真の補正：

「この写真の背景を削除し、印刷用にアップスケールしてください。」 → recraft_remove_background → recraft_creative_upscale

アセットの差し替え：

「スプライトシートのこの領域のテクスチャを、新しいデザインに差し替えてください。」 → recraft_texture_swap

キャンバスの拡張：

「被写体をトリミングせずに、この画像を 16:9 のバナーになるよう横に広げてください。」 → recraft_outpaint

自由なアイデアの検討：

「サーキットを走るレーシングカーのアイデアをいくつか試し、3 番目に似たものをさらに提案してください。」 → recraft_explore → recraft_explore_similar

プロンプトのブラッシュアップ：

「生成する前に、この大まかなプロンプトを改善してください：『看板を持つレッサーパンダ』。」 → recraft_enhance_prompt

開発

git clone https://github.com/muhammetali/recraft-mcp-server.git
cd recraft-mcp-server
npm install
npm run build
npm test
npm run audit:security
npm run verify

バージョン 1.2.0 では、24 個のツールをすべて維持しつつ、公式のモジュール式 MCP SDK v2 を使用しています。リリース時の確認事項、依存関係の判断、必要なランタイム機能については、セキュリティポリシーと依存関係レビューをご覧ください。

📄 ライセンス

MIT — LICENSEをご覧ください。