Flux Cloudfare MCP

🚀 Flux Cloudflare MCP

強力なModel Context Protocol (MCP)サーバーで、Cloudflare Worker APIを介してBlack Forest LabsのFluxモデルを使用してAIアシスタントに画像生成機能を提供します。

インストール • 主な機能 • 使用方法 • ドキュメント • コントリビュート

✨ 主な機能

• 🖼️ 高品質な画像生成：最先端の画像生成モデルであるFluxにアクセスできます。
• 🤖 シームレスなAI統合：ClaudeなどのAIアシスタントが直接画像を生成できるようになります。
• 🎛️ カスタマイズ可能なパラメータ：アスペクト比、推論ステップ数などを制御できます。
• 🔌 MCP互換：任意のMCPクライアント（Cursor、Claude Desktop、Cline、Zedなど）と互換性があります。
• 🔒 ローカル処理：すべてのリクエストはCloudflare Workerを通じて安全に処理されます。
• 💬 チャット補完：同じAPIを使用してテキスト補完を取得できます。

📦 インストール

NPXを使用した直接利用

FLUX_API_TOKEN=your_token FLUX_API_URL=your_api_url npx -y flux-cloudflare-mcp

ソースからのインストール

# リポジトリをクローン
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

🚀 Flux APIのセットアップ

このMCPサーバーは、Flux APIエンドポイントが必要です。APIをセットアップするには2つの選択肢があります。

オプション1: snakeying/flux-api-workerを使用してデプロイ（推奨）

snakeying/flux-api-workerは、Fluxモデルにアクセスするためのシンプルで効率的なCloudflare Workerを提供します。

1. flux-api-workerリポジトリをフォークします。
2. それをCloudflare Workersにデプロイします。
   • Cloudflareダッシュボードで新しいWorkerを作成します。
   • フォークしたリポジトリに接続します。
   • 必要な環境変数を設定します。
     • API_KEY：認証用のAPIキー
     • CF_ACCOUNT_ID：あなたのCloudflareアカウントID
     • CF_API_TOKEN：Workers AIアクセス権を持つあなたのCloudflare APIトークン
     • FLUX_MODEL：使用するFluxモデル（デフォルト："@cf/black-forest-labs/flux-1-schnell"）
3. デプロイが完了すると、APIはhttps://your-worker-name.your-subdomain.workers.devで利用可能になります。
4. このURLをFLUX_API_URLとして、選択したAPIキーをFLUX_API_TOKENとして使用します。

オプション2: aigem/cf-flux-remixを使用してデプロイ

Web UIを備えたより機能豊富な実装が必要な場合は、aigem/cf-flux-remixを使用できます。

1. cf-flux-remixリポジトリのインストール手順に従います。
2. デプロイが完了すると、APIはデプロイしたURLで利用可能になります。
3. このURLをFLUX_API_URLとして、設定したAPIキーをFLUX_API_TOKENとして使用します。

📚 ドキュメント

利用可能なツール

generate_image

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

{
  prompt: string;                // 必須: 生成する画像のテキスト説明
  num_inference_steps?: number;  // オプション: デノイジングステップ数 (1 - 4) (デフォルト: 4)
  aspect_ratio?: string;         // オプション: アスペクト比 (例: "16:9", "4:3") (デフォルト: "1:1")
}

🔧 使用方法

Cursor統合

方法1: mcp.jsonを使用する

1. プロジェクトディレクトリ内の.cursor/mcp.jsonファイルを作成または編集します。

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}

2. YOUR_TOKENを実際のFlux APIトークンに、YOUR_API_URLをAPI URLに置き換えます。
3. Cursorを再起動して変更を適用します。

方法2: Cursor MCP設定を使用する

1. Cursorを開き、設定に移動します。
2. "MCP"または"Model Context Protocol"セクションに移動します。
3. "Add Server"または同等のボタンをクリックします。
4. 適切なフィールドに次のコマンドを入力します。

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

5. YOUR_TOKENを実際のFlux APIトークンに、YOUR_API_URLをAPI URLに置き換えます。
6. 設定を保存し、必要に応じてCursorを再起動します。

Claude Desktop統合

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "npx",
      "args": ["-y", "flux-cloudflare-mcp"],
      "env": {
        "FLUX_API_TOKEN": "YOUR_TOKEN",
        "FLUX_API_URL": "YOUR_API_URL"
      }
    }
  }
}

💻 ローカル開発

1. リポジトリをクローンします。

git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

🔧 技術的詳細

• Model Context Protocol SDK - コアMCP機能
• Cloudflare Workers - 画像生成用のサーバーレスAPI
• TypeScript - 型安全性と最新のJavaScript機能
• Zod - ランタイム型検証

⚙️ 設定

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

• FLUX_API_TOKEN：Flux APIとの認証用のAPIトークン
• FLUX_API_URL：デプロイしたFlux APIのURL（snakeying/flux-api-workerまたはaigem/cf-flux-remixから）

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

一般的な問題

認証エラー

• FLUX_API_TOKENが環境に正しく設定されていることを確認します。
• トークンが有効であることを、Flux APIに直接テストすることで確認します。

API接続問題

• Flux API（Cloudflare Worker）が実行中でアクセス可能であることを確認します。
• ネットワークがCloudflare Workersへの接続を許可していることを確認します。

セーフティフィルターがトリガーされた

• モデルには組み込みのセーフティフィルターがあり、特定のプロンプトをブロックすることがあります。
• 問題のある可能性のある内容を避けるために、プロンプトを変更してみてください。

🤝 コントリビュート

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. あなたの機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを開きます。

📄 ライセンス

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

🔗 リソース

• Model Context Protocolドキュメント
• Cloudflare Workersドキュメント
• Fluxモデルドキュメント
• MCP TypeScript SDK
• snakeying/flux-api-worker - シンプルなFlux APIの実装
• aigem/cf-flux-remix - Web UIを備えた機能豊富なFlux API