Install
$ agentstack add mcp-ai-forever-mcp-kandinsky ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
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.
Тарифы
Kandinsky API предоставляет бесплатный тариф с лимитом 100 запросов в месяц. Подробнее о тарифах и возможностях можно узнать на странице для разработчиков.
Как подключить 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в рабочей директории проекта.
Описание инструмента
kandinskygenerateimage
| Параметр | Тип | Описание | |------------------|--------|-----------------------------------------------------------------| | prompt | str | Описание изображения | | filename | str | Имя файла для сохранения (например, cat.png) | | projectdir | str | Абсолютный путь к папке проекта | | width | int | Ширина (по умолчанию 1024) | | height | int | Высота (по умолчанию 1024) | | style | str | Стиль (DEFAULT, KANDINSKY, UHD, ANIME; по умолчанию DEFAULT) | | negativeprompt | 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
- Source: ai-forever/mcp_kandinsky
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.