Flux Image Generator

🚀 流動雲flare MCP項目

本項目是基於Cloudflare Workers API的MCP服務器項目，藉助Flux模型實現圖像生成，適用於Claude Desktop和Cursor等多種MCP客戶端。

🚀 快速開始

克隆倉庫

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

安裝依賴

npm install

構建項目

npm run build

✨ 主要特性

• 模型支持：集成Flux模型，可生成高質量圖像。
• 協議兼容性：支持MCP協議，能與其他MCP客戶端兼容。
• 雲flare workers：運用Cloudflare無服務器架構實現後端邏輯。
• 類型安全：通過TypeScript保障代碼質量。
• 數據校驗：使用Zod進行運行時數據驗證。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

構建項目

npm run build

📚 詳細文檔

配置說明

項目需要以下環境變量：

• FLUX_API_TOKEN：認證用API令牌。
• FLUX_API_URL：接入的Flux API地址（來自snakeying/flux-api-worker或aigem/cf-flux remix）。

整合指南

在Cursor中的配置方法

方法一: 修改配置文件

編輯~/.cursor/settings.json添加以下內容：

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

方法二: 使用Cursor設置界面

1. 打開Cursor，進入設置界面。
2. 進入"MCP"或"模型上下文協議"選項。
3. 點擊"添加服務器"。
4. 輸入以下命令：

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

在Claude Desktop中的配置方法

在settings.json中添加：

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

🔧 技術細節

技術棧

• MCP SDK：提供核心MCP功能。
• Cloudflare Workers：無服務器架構。
• TypeScript：實現類型安全。
• Zod：運行時數據校驗。

項目地址

• GitHub倉庫

📄 許可證

本項目遵循MIT許可證，具體內容請參閱LICENSE文件。

🔗 資源鏈接

• MCP協議文檔
• Cloudflare Workers文檔
• Flux模型文檔
• MCP TypeScript SDK
• snakeying/flux-api-worker - 簡單的Flux API實現
• aigem/cf-flux remix - 功能豐富的Flux API帶Web界面

💪 貢獻指南

歡迎貢獻！請參考[CONTRIBUTING.md]。

📋 項目標籤