Replicate Flux

MCP Replicate FLUX

Replicate の FLUX モデルを使用して画像を生成し、Cloudflare R2 に保存する Model Context Protocol（MCP）サーバーです。

Features 機能

• Replicate の black-forest-labs/flux-schnell モデルを使用して画像を生成します
• 生成した画像を Cloudflare R2 に保存します
• アクセス可能な画像 URL を返します
• カスタムプロンプトとファイル名に対応しています

Prerequisites 前提条件

• Node.js（v16 以降）
• Replicate API トークン
• Cloudflare R2 バケットと認証情報
• npm または yarn

Environment Variables 環境変数

.env ファイルに必要な環境変数：

REPLICATE_API_TOKEN=your_replicate_token
STORAGE_ENDPOINT=your_r2_endpoint
STORAGE_ACCESS_KEY=your_r2_access_key
STORAGE_SECRET_KEY=your_r2_secret_key
STORAGE_BUCKET=your_bucket_name
STORAGE_DOMAIN=your_domain

Local Installation ローカルインストール

Installing via Smithery

Smithery を使用して、Claude Desktop 用の MCP Replicate FLUX を自動的にインストールする方法：

npx -y @smithery/cli install @andylee20014/mcp-replicate-flux --client claude

Installing manually

以下の手順に従って、プロジェクトをローカルにセットアップします：

# Clone the repository
git clone https://github.com/andylee20014/mcp-replicate-flux.git
cd mcp-replicate-flux

# Install dependencies
npm install

# Create .env file and add your credentials
cp .env.example .env
# Edit .env with your actual credentials

Cloudflare R2 バケットに、アップロードした画像へのパブリックアクセスを許可する適切な CORS 設定があることを確認してください。

Running Locally ローカルでの実行

MCP サーバーをローカルで起動するには：

node index.js

サーバーが起動し、標準入力／出力を介して MCP プロトコルメッセージを待ち受けます。

Usage 使い方

このサーバーは、2 つのパラメーターを受け取る generate-image ツールを提供します：

• prompt：画像生成に使用するテキストプロンプト
• filename：生成した画像に付けるファイル名

Integration Example 統合例

MCP クライアントライブラリを使用して、この MCP サーバーと連携する例を示します：

const { McpClient } = require('@modelcontextprotocol/sdk/client/mcp.js')

async function generateImage(prompt, filename) {
  const client = new McpClient()
  // Connect to your running MCP server
  await client.connect(yourTransport)
  
  const result = await client.tools.call('generate-image', {
    prompt,
    filename
  })
  
  return result
}

応答例：

{
  "content": [
    { "type": "text", "text": "Image successfully generated and uploaded to Cloudflare R2" },
    { "type": "image", "url": "https://your-domain.com/filename.jpg" }
  ]
}

Testing テスト

画像生成とアップロード機能を検証するためのテストスクリプトが用意されています。

Running the test テストの実行

node test.js

テストスクリプトでは、次の処理を行います：

1. サンプルのプロンプトで画像を生成します
2. 画像を Cloudflare R2 にアップロードします
3. アクセス可能な URL を返します

テスト出力例：

Generating image with prompt: "a beautiful girl"
Filename: test-1234567890.jpg
Image generated and uploaded successfully!
Image URL: https://your-domain.com/test-1234567890.jpg

test.js のプロンプトを変更して、さまざまな画像生成シナリオをテストできます。

Cursor MCP Configuration Cursor MCP の設定

Cursor で MCP サーバーを設定する方法は 2 つあります：

Method 1: Complete Configuration 完全な設定

すべての環境変数を含むファイルを ~/.cursor/mcp.json に作成します：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"],
      "description": "使用Replicate的FLUX模型生成图片并存储到Cloudflare R2的MCP服务器",
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_token",
        "STORAGE_ENDPOINT": "your_r2_endpoint",
        "STORAGE_ACCESS_KEY": "your_r2_access_key",
        "STORAGE_SECRET_KEY": "your_r2_secret_key",
        "STORAGE_BUCKET": "your_bucket_name",
        "STORAGE_DOMAIN": "your_domain"
      }
    }
  }
}

Method 2: Minimal Configuration 最小限の設定

環境変数を別途（システム環境変数または .env ファイルを使用して）管理する場合は、最小限の設定を使用できます：

{
  "mcpServers": {
    "replicate-flux": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\mcp-replicate-flux\\index.js"]
    }
  }
}

最小限の設定を使用する場合は、環境変数が次のいずれかに正しく設定されていることを確認してください：

• システム環境変数
• プロジェクトディレクトリ内の .env ファイル
• クラウドプラットフォームの環境変数（デプロイ済みサーバーの場合）

Notes 注意事項

• description フィールドは、どちらの方法でも省略可能です
• 設定ファイル内の環境変数は、システム環境変数より優先されます
• 設定を変更した後、変更を適用するために Cursor を再起動してください

Project Structure プロジェクト構成

mcp-replicate-flux/
├── .env                  # Environment variables
├── index.js             # MCP server entry point
├── generateImage.js      # Image generation and R2 upload logic
├── test.js              # Test script
└── README.md            # Project documentation

Troubleshooting トラブルシューティング

よくある問題

1. 画像生成に失敗する：Replicate API トークンと利用枠を確認してください

2. R2 へのアップロードに失敗する：R2 の認証情報とバケットの権限を確認してください

3. 生成された画像にアクセスできない：R2 バケットに適切な CORS 設定があることを確認してください

4. 画像生成に失敗する：Replicate API トークンと利用枠を確認してください

5. R2 へのアップロードに失敗する：R2 の認証情報とバケットの権限を確認してください

6. 生成された画像にアクセスできない：R2 バケットに適切な CORS 設定があることを確認してください

MCP プロトコルの説明

Model Context Protocol（MCP）は、異なる AI システム間の相互運用性を実現する AI モデルの対話標準です。このサーバーは、MCP 互換のあらゆるクライアントで使用できる MCP ツールを実装しています。

MCP の詳細については、こちらをご覧ください：https://mcp.freeaigen.com/

参考リンク

• Model Context Protocol ドキュメント
• Replicate API ドキュメント
• Cloudflare R2 ドキュメント
• Flux AI モデル

ライセンス

MIT