Flux Image MCP Server

🚀 Flux Image MCPサーバー：Flux Schnellモデルを使用したReplicateによる画像生成

このMCPサーバーは、Flux Schnellモデルを利用して、Replicate上で画像生成機能を提供します。

🚀 クイックスタート

📦 インストール

0. MCP SDKをグローバルにインストールする

npm install -g @modelcontextprotocol/sdk@latest

1. このリポジトリをMCPサーバーディレクトリにクローンする

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

2. サーバーをビルドする

npm run build

3. サーバー設定をMCP設定ファイル（グローバルまたはワークスペース）に追加する

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🔧 設定要件

サーバーには以下の環境変数が必要です。

• REPLICATE_API_TOKEN：あなたのReplicate APIトークンです。Replicateアカウント設定から取得できます。

💻 使用例

基本的な使用法

インストールが完了したら、以下のツールを設定します。

generate_image

Flux Schnellモデルを使用して、テキストプロンプトに基づいて画像を生成します。

パラメータ：

• prompt (string, 必須)：必要な画像を説明するテキスト

使用例：

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

このツールは、以下の内容を含むJSON応答を返します。

• status：生成リクエストの状態
• output：生成された画像のURL（成功した場合）
• error：エラー情報（失敗した場合）

📚 詳細ドキュメント

開発ガイド

サーバーを変更するには、以下の手順に従います。

1. src/index.ts のソースコードを変更します。
2. サーバーを再構築します：npm run build
3. 変更を適用するためにMCPサーバーを再起動します。

エラー処理

サーバーには包括的なエラー処理機能が備わっており、以下の状況をカバーしています。

• APIトークンが不足している場合
• パラメータが無効な場合
• APIリクエストが失敗した場合
• ネットワーク問題が発生した場合

⚠️ セキュリティに関する注意事項

• Replicate APIトークンをバージョン管理システムにコミットしないでください。
• 常に環境変数を通じてトークンを提供してください。
• サーバーはすべての入力パラメータを検証し、安全性を確保します。