Image Generation (Flux Schnell)

🚀 画像生成 MCP サーバ

このサーバは、MCP (Model Context Protocol) の実装であり、Replicate の black-forest-labs/flux-schnell モデルを使用して画像を生成するためのものです。理想的には Cursor の MCP 機能と一緒に使用されますが、他の MCP クライアントとも互換性があります。

🚀 クイックスタート

この画像生成 MCP サーバは、Replicate の特定モデルを利用して画像を生成するための MCP サーバの実装です。Cursor や他の MCP クライアントと連携して使用できます。

✨ 主な機能

• テキストプロンプトから画像を生成します。
• 画像のパラメータ（解像度、アスペクト比、品質）を設定可能です。
• 生成された画像を指定されたディレクトリに保存します。
• MCP プロトコルに完全に準拠しています。
• エラー処理と検証機能が備わっています。

📦 インストール

前提条件

• Node.js 16+
• Replicate API トークン
• TypeScript の MCP SDK

セットアップ手順

1. リポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. src/imageService.ts の apiToken 定数を直接更新して、あなたの Replicate API トークンを設定します。

// 環境変数は Cursor で設定が難しいため、ここに直接 API トークンを追加してください
const apiToken = "your-replicate-api-token-here";

⚠️ 重要提示

Claude を使用する場合は、ルートディレクトリに .env ファイルを作成し、API トークンを以下のように設定してください。

REPLICATE_API_TOKEN=your-replicate-api-token-here

その後、プロジェクトをビルドします。

npm run build

💻 使用例

基本的な使用法

Cursor と一緒に使用する場合：

1. 設定に移動します。
2. 機能を選択します。
3. 一番下の「MCP サーバ」までスクロールします。
4. 「新しい MCP サーバを追加」をクリックします。
5. タイプを「Command」に設定します。
6. コマンドを node ./path/to/dist/server.js に設定します。

高度な使用法

API パラメータ

リクエスト例

{
  "prompt": "黑色森林蛋糕，上面写着 '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"
}

レスポンス例

{
  "status": "success",
  "message": "画像已生成并保存到指定目录。",
  "data": {
    "filename": "black_forest_cake.png",
    "size": "2.5 MB",
    "dimensions": "1920x1080"
  }
}

🔧 技術詳細

エラー処理

• 入力エラー：プロンプトまたはパラメータが無効な場合、検証エラーが返されます。
• API エラー：Replicate API の呼び出しに失敗した場合、関連するエラー情報が返されます。
• 保存エラー：指定されたディレクトリに画像を保存できない場合、保存エラーが返されます。

📄 ライセンス

このコードは MIT License の保護を受けています。