# Mcp Kandinsky

> MCP server for generating images using Kandinsky API.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ai-forever-mcp-kandinsky`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ai-forever](https://agentstack.voostack.com/s/ai-forever)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ai-forever](https://github.com/ai-forever)
- **Source:** https://github.com/ai-forever/mcp_kandinsky

## Install

```sh
agentstack add mcp-ai-forever-mcp-kandinsky
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Kandinsky

MCP Kandinsky — это MCP (Model Context Protocol) сервер, предоставляющий инструмент для генерации изображений с помощью нейросети [Kandinsky](https://www.sberbank.com/promo/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](https://fusionbrain.ai/), перейдя в раздел API.

### Тарифы
Kandinsky API предоставляет бесплатный тариф с лимитом **100 запросов в месяц**. Подробнее о тарифах и возможностях можно узнать на [странице для разработчиков](https://fusionbrain.ai/developers/).

## Как подключить MCP Kandinsky к агенту (Cursor, Windsurf и др.)
Добавьте MCP-сервер в конфиг агента, например, в файл `.cursor/mcp.json` или аналогичный для вашей IDE:

```json
"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. См. файл LICENSE для подробностей.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ai-forever](https://github.com/ai-forever)
- **Source:** [ai-forever/mcp_kandinsky](https://github.com/ai-forever/mcp_kandinsky)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ai-forever-mcp-kandinsky
- Seller: https://agentstack.voostack.com/s/ai-forever
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.