remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Replicate's 'black-forest-labs/flux-schnell' model to generate images from text prompts

画像生成MCPサーバー

Replicate のblack-forest-labs/flux-schnellモデルを使用して画像を生成するためのMCP (Model Context Protocol)サーバー実装。

理想的には、Cursor の MCP 機能と一緒に使用しますが、どの MCP クライアントでも使用できます。

特徴

テキストプロンプトから画像を生成する
設定可能な画像パラメータ（解像度、アスペクト比、品質）
生成された画像を指定されたディレクトリに保存する
MCPプロトコルに完全準拠
エラー処理と検証

前提条件

Node.js 16以上
APIトークンを複製する
MCP 向け TypeScript SDK

設定

リポジトリをクローンする
依存関係をインストールします:
npm install
apiToken定数を更新して、 src/imageService.tsのコードに Replicate API トークンを直接追加します。
// No environment variables are used since they can't be easily set in cursor const apiToken = "your-replicate-api-token-here";
注: Claude で使用する場合は、ルートディレクトリに.envファイルを作成し、そこに API トークンを設定できます。
REPLICATE_API_TOKEN=your-replicate-api-token-here
次にプロジェクトをビルドします。
npm run build

使用法

カーソルで使用するには:

設定に移動
機能を選択
「MCPサーバー」までスクロールします。
「新しいMCPサーバーを追加」をクリックします
タイプを「コマンド」に設定する
コマンドを次のように設定します: node ./path/to/dist/server.js

APIパラメータ

パラメータ	タイプ	必須	デフォルト	説明
`prompt`	弦	はい	-	画像生成のためのテキストプロンプト
`output_dir`	弦	はい	-	生成された画像を保存するサーバーディレクトリパス
`go_fast`	ブール値	いいえ	間違い	高速生成モードを有効にする
`megapixels`	弦	いいえ	「1」	解像度の品質（「1」、「2」、「4」）
`num_outputs`	番号	いいえ	1	生成する画像の数（1～4）
`aspect_ratio`	弦	いいえ	「1:1」	アスペクト比（「1:1」、「4:3」、「16:9」）
`output_format`	弦	いいえ	「ウェブ」	画像形式（「webp」、「png」、「jpeg」）
`output_quality`	番号	いいえ	80	圧縮品質（1～100）
`num_inference_steps`	番号	いいえ	4	ノイズ除去ステップ数（4～20）

リクエスト例

{
  "prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'",
  "output_dir": "/var/output/images",
  "filename": "black_forest_cake",
  "output_format": "webp"
  "go_fast": true,
  "megapixels": "1",
  "num_outputs": 2,
  "aspect_ratio": "1:1"
}

回答例

{
  "image_paths": [
    "/var/output/images/output_0.webp",
    "/var/output/images/output_1.webp"
  ],
  "metadata": {
    "model": "black-forest-labs/flux-schnell",
    "inference_time_ms": 2847
  }
}

エラー処理

サーバーは次のエラータイプを処理します。

検証エラー（無効なパラメータ）
API エラー (API の問題を複製する)
サーバーエラー（ファイルシステム、権限）
不明なエラー（予期しない問題）

各エラー応答には次の内容が含まれます。

エラーコード
人間が読めるメッセージ
詳細なエラー情報

ライセンス

ISC

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

generate-image

ユーザーは、Replicate のモデルを使用して、構成可能なパラメータと完全な MCP プロトコル準拠により、テキストプロンプトから画像を生成できます。

Related Resources

Reddit Discussion about this server

Image Generation MCP Server