What is Mcp Kandinsky

mcp_kandinsky is an MCP server that provides a tool for generating images using the Kandinsky API, specifically version 3.1, through a neural network.

Use cases

Use cases include generating artwork based on specific themes, creating illustrations for stories or articles, designing game assets, and producing marketing visuals tailored to particular concepts.

How to use

To use mcp_kandinsky, you need to set up your environment with the required API keys and configure your agent (like Cursor or Windsurf) to connect to the MCP server. You can then invoke the image generation tool by providing a text prompt and other parameters.

Key features

Key features include image generation from text prompts, style selection (DEFAULT, KANDINSKY, UHD, ANIME), support for negative prompts, customizable image dimensions, file saving with overwrite control, and specifying a project directory for saving results.

Where to use

mcp_kandinsky can be used in various fields such as digital art creation, game design, advertising, and any area that requires automated image generation based on textual descriptions.

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:

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

Вызов инструмента из агента (например, через 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

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

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

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

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

Лицензия

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