Replicate Flux MCP

🚀 MCP サーバー：Replicate - モデルコンテキストプロトコルに基づく画像生成サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）に基づいて構築されたAI画像生成サーバーです。Replicateプラットフォーム上の高度なAIモデルを使用した画像生成をサポートしています。現在の実装には以下が含まれます：

• Flux Schnellモデルを使用した複数画像の一括生成
• 複数プロンプトモードのサポート
• 画像バリエーション生成機能
• SVG画像生成インターフェース

✨ 主な機能

1. 多図生批 (generate_multiple_images)

複数の異なるプロンプトに基づいて、一度に複数の画像を生成することができます。

{
  "prompts": [
    "A serene mountain lake at sunset", 
    "A bustling city street at night", 
    "A peaceful garden in spring"
  ]
}

2. 多提示モード

複数の画像生成リクエストを同時に処理することができ、各リクエストには異なるパラメータを指定できます。

{
  "requests": [
    {
      "modelId": "black-forest-labs/flux-schnell",
      "prompt": "A futuristic city skyline at night",
      "width": 1024,
      "height": 512
    },
    {
      "modelId": "recraft-ai/recraft-v3-svg", 
      "prompt": "A character portrait in anime style", 
      "style": "anime"
    }
  ]
}

3. 画像バリエーションの一括生成 (generate_image_variants)

指定されたプロンプトに基づいて、複数の異なるバリエーションを生成することができます。

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

4. SVG画像サポート

Recraft V3 SVGモデルを通じて、高品質のSVG画像生成機能を提供します。

🔧 技術詳細

• モデルコンテキストプロトコル（MCP）SDK - ツールやリソース管理などの基本的なサーバー機能を提供します。
• Replicate API - AIモデル呼び出しインターフェースを実装します。
• TypeScript - コードの型安全性を保証します。
• Zod - 厳密なランタイムデータ検証を行います。

📦 インストール

src/config/index.ts の CONFIG オブジェクトを変更することで、設定を行うことができます。

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2", 
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // ms
};

📚 ドキュメント

典型的なアプリケーションシナリオ

多提示例	提示バリエーション例

💻 使用例

複数画像の一括生成

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

画像バリエーションの生成

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

🛠️ トラブルシューティング

一般的な問題とその解決策：

1. ネットワーク接続問題：インターネットアクセス権限を確認し、サーバーがReplicate APIにアクセスできることを確認してください。
2. モデルの読み込み失敗：モデルIDが正しいことを確認し、Replicateプラットフォーム上に利用可能なバージョンがあることを確認してください。
3. 生成タイムアウト：pollingInterval の値を増やすか、ネットワーク環境を最適化してください。

🤝 コントリビューションガイド

どんな貢献も大歓迎です！GitHubリポジトリを通じて問題やPull Requestを送信してください。プロジェクトのドキュメントとコード規約を読んでから貢献することをおすすめします。

🔗 リソースリンク

• 公式ドキュメント：モデルコンテキストプロトコル（MCP）
• Replicateプラットフォーム：Replicate AI Models
• オープンソースリポジトリ：GitHub Repository

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細は LICENSE ファイルを参照してください。