Skip to main content
Glama
deenesjakoruzh
AceDataCloud

FluxMCP

by AceDataCloud
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

FluxMCP

PyPI version PyPI downloads CI 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

Related MCP server: DiffuGen

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

Инструмент

Описание

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-токен

  1. Зарегистрируйтесь на платформе AceDataCloud

  2. Перейдите на страницу документации API

  3. Нажмите "Acquire", чтобы получить ваш API-токен

  4. Скопируйте токен для использования ниже

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

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

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

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

Claude.ai

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

  1. Перейдите в Claude.ai Settings → Integrations → Add More

  2. Введите URL сервера: https://flux.mcp.acedata.cloud/mcp

  3. Завершите процесс входа через OAuth

  4. Начните использовать инструменты в вашем диалоге

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

  1. Перейдите в Settings → Tools → AI Assistant → Model Context Protocol (MCP)

  2. Нажмите Add → HTTP

  3. Вставьте:

{
  "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.

Ссылки

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2dRelease cycle
57Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • vap-e

    AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.

  • avots

    Image, video, audio, face-swap, talking avatars and chat across 300+ AI models, one balance.

  • Createya — AI Image & Video Generation

    100+ AI models: FLUX, Sora, Veo, Kling, Runway, Suno. OAuth or Bearer. No VPN. RU billing.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AceDataCloud/FluxMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server