画像生成MCPサーバー

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

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

特徴

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

Related MCP server: Together AI Image Server

前提条件

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
  }
}