mcp_kandinsky by ai-forever - MCP Server

MCP Kandinsky

MCP Kandinsky — это MCP (Model Context Protocol) сервер, предоставляющий инструмент для генерации изображений с помощью нейросети Kandinsky через официальный API. В настоящее время по API доступна версия Kandinsky 3.1.

Возможности

Генерация изображений по текстовому описанию (prompt)
Поддержка выбора стиля (DEFAULT, KANDINSKY, UHD, ANIME)
Поддержка негативных промптов
Настройка размера изображения (width, height)
Сохранение результата в файл с контролем перезаписи
Явное указание папки проекта для сохранения (project_dir)

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

Для работы с MCP Kandinsky вам понадобятся данные для авторизации, которые нужно сохранить в переменных окружения.

KANDINSKY_API_KEY — ваш API-ключ
KANDINSKY_SECRET_KEY — ваш Secret-ключ

Получить авторизационные данные можно после регистрации на сайте FUSION BRAIN, перейдя в раздел API.

Как подключить MCP Kandinsky к агенту (Cursor, Windsurf и др.)

Добавьте MCP-сервер в конфиг агента, например, в файл .cursor/mcp.json или аналогичный для вашей IDE:

"mcpServers": {
    "mcp-kandinsky": {
        "command": "uvx",
        "args": [
            "--from", "mcp_kandinsky", "mcp-kandinsky"
        ],
        "enabled": true,
        "env": {
            "KANDINSKY_API_KEY": "ВАШ_API_KEY",
            "KANDINSKY_SECRET_KEY": "ВАШ_SECRET_KEY"
        }
    }
}

Пример использования инструмента агентом

Вызов инструмента из агента (например, через Cursor):

mcp-kandinsky/kandinsky_generate_image
Arguments
{
  "prompt": "Весенняя Москва в мае, сирень, дождь и солнце, в стиле акварельной живописи",
  "filename": "moskva_v_mae.png",
  "project_dir": "/Users/you/myproject",
  "width": 1024,
  "height": 1024,
  "style": "DEFAULT",
  "negative_prompt": "",
  "overwrite": false
}
Response
Изображение успешно сгенерировано и сохранено в kandinsky/moskva_v_mae.png.

Пояснения:

Все параметры передаются через интерфейс агента.
project_dir — абсолютный путь к папке проекта, в которой работает агент в настоящий момент. Папка kandinsky будет создана внутри неё.
Ответ — строка с результатом (успех или причина отказа).
Файл сохраняется в папку kandinsky в рабочей директории проекта.

Описание инструмента

kandinsky_generate_image

Параметр	Тип	Описание
prompt	str	Описание изображения
filename	str	Имя файла для сохранения (например, cat.png)
project_dir	str	Абсолютный путь к папке проекта
width	int	Ширина (по умолчанию 1024)
height	int	Высота (по умолчанию 1024)
style	str	Стиль (DEFAULT, KANDINSKY, UHD, ANIME; по умолчанию DEFAULT)
negative_prompt	str	Негативный промпт (опционально)
overwrite	bool	Перезаписывать файл, если он уже существует (по умолчанию False)

Возвращает: строку-результат с сообщением об успехе или причине отказа.

Логика работы

Проверяется наличие папки kandinsky внутри project_dir, при необходимости создаётся.
Если файл с таким именем уже есть и overwrite=False, генерация не происходит, возвращается сообщение о наличии файла.
Если файла нет или overwrite=True, происходит генерация, файл сохраняется (или перезаписывается).
Возвращается сообщение об успешном сохранении или причине отказа.

Документация API: https://fusionbrain.ai/docs/doc/api-dokumentaciya/

Лицензия

Этот проект распространяется под лицензией MIT.