FluxMCP

Name: FluxMCP
Author: AceDataCloud

PyPI version PyPI downloads License: MIT MCP Python 3.10+

Сервер Model Context Protocol (MCP) для генерации и редактирования ИИ-изображений с использованием Flux через платформу AceDataCloud.

Создавайте и редактируйте потрясающие ИИ-изображения с помощью моделей Flux (flux-dev, flux-pro, flux-kontext) прямо из Claude, Cursor или любого другого клиента, поддерживающего MCP.

Возможности

Генерация изображений — создание изображений по текстовым запросам с помощью 6 моделей Flux
Редактирование изображений — редактирование существующих изображений с помощью контекстно-зависимых моделей Flux Kontext
Управление задачами — отслеживание асинхронных задач генерации и пакетные запросы статуса
Руководство по моделям — встроенные рекомендации по выбору модели и составлению промптов
Двойной транспорт — режимы stdio (локальный) и HTTP (удаленный/облачный)
Готовность к Docker — контейнеризация с манифестами развертывания K8s
Безопасность — аутентификация через Bearer-токен с изоляцией каждого запроса в режиме HTTP

Справочник инструментов

Инструмент	Описание
`flux_generate_image`	Генерация ИИ-изображений по текстовому запросу с использованием Flux.
`flux_edit_image`	Редактирование существующего изображения с помощью Flux по текстовому запросу.
`flux_list_models`	Список всех доступных моделей Flux и их возможностей.
`flux_list_actions`	Список всех доступных инструментов Flux и сценариев их использования.
`flux_get_task`	Запрос статуса и результата задачи генерации изображения Flux.
`flux_get_tasks_batch`	Запрос нескольких задач генерации изображений Flux одновременно.

Быстрый старт

1. Получите ваш API-токен

Зарегистрируйтесь на платформе AceDataCloud
Перейдите на страницу документации API
Нажмите "Acquire", чтобы получить ваш API-токен
Скопируйте токен для использования ниже

2. Используйте размещенный сервер (рекомендуется)

AceDataCloud предоставляет управляемый MCP-сервер — локальная установка не требуется.

Эндпоинт: https://flux.mcp.acedata.cloud/mcp

Все запросы требуют Bearer-токен. Используйте API-токен из шага 1.

Claude.ai

Подключитесь напрямую на Claude.ai через OAuth — API-токен не требуется:

Перейдите в Claude.ai Settings → Integrations → Add More
Введите URL сервера: https://flux.mcp.acedata.cloud/mcp
Завершите процесс входа через OAuth
Начните использовать инструменты в вашем диалоге

Claude Desktop

Добавьте в ваш конфиг (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf

Добавьте в ваш конфиг MCP (.cursor/mcp.json или .windsurf/mcp.json):

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code (Copilot)

Добавьте в ваш конфиг MCP для VS Code (.vscode/mcp.json):

{
  "servers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Или установите расширение Ace Data Cloud MCP для VS Code, которое объединяет все 15 MCP-серверов с настройкой в один клик.

JetBrains IDEs

Перейдите в Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Нажмите Add → HTTP
Вставьте:

{
  "mcpServers": {
    "flux": {
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude Code

Claude Code поддерживает MCP-серверы нативно:

claude mcp add flux --transport http https://flux.mcp.acedata.cloud/mcp \
  -h "Authorization: Bearer YOUR_API_TOKEN"

Или добавьте в .mcp.json вашего проекта:

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cline

Добавьте в настройки MCP для Cline (.cline/mcp_settings.json):

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Amazon Q Developer

Добавьте в вашу конфигурацию MCP:

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Roo Code

Добавьте в настройки MCP для Roo Code:

{
  "mcpServers": {
    "flux": {
      "type": "streamable-http",
      "url": "https://flux.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Continue.dev

Добавьте в .continue/config.yaml:

mcpServers:
  - name: flux
    type: streamable-http
    url: https://flux.mcp.acedata.cloud/mcp
    headers:
      Authorization: "Bearer YOUR_API_TOKEN"

Zed

Добавьте в настройки Zed (~/.config/zed/settings.json):

{
  "language_models": {
    "mcp_servers": {
      "flux": {
        "url": "https://flux.mcp.acedata.cloud/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

Тест cURL

# Health check (no auth required)
curl https://flux.mcp.acedata.cloud/health

# MCP initialize
curl -X POST https://flux.mcp.acedata.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

3. Или запустите локально (альтернатива)

Если вы предпочитаете запускать сервер на своей машине:

# Install from PyPI
pip install mcp-flux-pro
# or
uvx mcp-flux-pro

# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"

# Run (stdio mode for Claude Desktop / local clients)
mcp-flux-pro

# Run (HTTP mode for remote access)
mcp-flux-pro --transport http --port 8000

Claude Desktop (локально)

{
  "mcpServers": {
    "flux": {
      "command": "uvx",
      "args": ["mcp-flux-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your_token_here"
      }
    }
  }
}

Docker (самостоятельный хостинг)

docker pull ghcr.io/acedatacloud/mcp-flux-pro:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-flux-pro:latest

Клиенты подключаются со своим собственным Bearer-токеном — сервер извлекает токен из заголовка Authorization каждого запроса.

Доступные инструменты

Инструмент	Описание
`flux_generate_image`	Генерация изображений по текстовым запросам с выбором модели
`flux_edit_image`	Редактирование существующих изображений с помощью текстовых инструкций
`flux_get_task`	Запрос статуса отдельной задачи генерации
`flux_get_tasks_batch`	Запрос статусов нескольких задач одновременно
`flux_list_models`	Список всех доступных моделей Flux и их возможностей
`flux_list_actions`	Показать все инструменты и примеры рабочих процессов

Доступные промпты

Промпт	Описание
`flux_image_generation_guide`	Руководство по выбору подходящего инструмента и модели
`flux_prompt_writing_guide`	Лучшие практики написания эффективных промптов
`flux_workflow_examples`	Примеры распространенных рабочих процессов

Поддерживаемые модели

Модель	Качество	Скорость	Формат размера	Лучше всего подходит для
`flux-dev`	Хорошее	Быстро	Пиксели (256-1440px)	Быстрое прототипирование
`flux-pro`	Высокое	Средне	Пиксели (256-1440px)	Промышленное использование
`flux-pro-1.1`	Высокое	Средне	Пиксели (256-1440px)	Лучшее следование промпту
`flux-pro-1.1-ultra`	Высшее	Медленнее	Соотношение сторон	Максимальное качество
`flux-kontext-pro`	Высокое	Средне	Соотношение сторон	Редактирование изображений
`flux-kontext-max`	Высшее	Медленнее	Соотношение сторон	Сложное редактирование

Примеры использования

Генерация изображения

"Generate a photorealistic mountain landscape at golden hour"
→ flux_generate_image(prompt="...", model="flux-pro-1.1-ultra", size="16:9")

Редактирование изображения

"Add sunglasses to the person in this photo"
→ flux_edit_image(prompt="Add sunglasses", image_url="https://...", model="flux-kontext-pro")

Проверка статуса задачи

"What's the status of my generation?"
→ flux_get_task(task_id="...")

Переменные окружения

Переменная	Обязательно	По умолчанию	Описание
`ACEDATACLOUD_API_TOKEN`	Да (stdio)	—	API-токен от AceDataCloud
`ACEDATACLOUD_API_BASE_URL`	Нет	`https://api.acedata.cloud`	Базовый URL API
`ACEDATACLOUD_OAUTH_CLIENT_ID`	Нет	—	OAuth client ID (хостинг-режим)
`ACEDATACLOUD_PLATFORM_BASE_URL`	Нет	`https://platform.acedata.cloud`	Базовый URL платформы
`FLUX_REQUEST_TIMEOUT`	Нет	`1800`	Тайм-аут запроса в секундах
`MCP_SERVER_NAME`	Нет	`flux`	Имя MCP-сервера
`LOG_LEVEL`	Нет	`INFO`	Уровень логирования

Разработка

Настройка

git clone https://github.com/AceDataCloud/FluxMCP.git
cd FluxMCP
pip install -e ".[all]"
cp .env.example .env
# Edit .env with your API token

Линтинг и форматирование

ruff check .
ruff format .
mypy core tools main.py

Тестирование

# Unit tests
pytest --cov=core --cov=tools

# Skip integration tests
pytest -m "not integration"

# With coverage report
pytest --cov=core --cov=tools --cov-report=html

Git-хуки

git config core.hooksPath .githooks

Справочник API

Этот MCP-сервер использует AceDataCloud Flux API:

POST /flux/images — Генерация или редактирование изображений
POST /flux/tasks — Запрос статуса задачи (одиночной или пакетной)

Полная документация API: platform.acedata.cloud

Лицензия

Лицензия MIT — подробности см. в LICENSE.