https://github.com/ai-forever/mcp_kandinsky
MCP server for generating images using Kandinsky API.
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (2.5%) to scientific vocabulary
Repository
MCP server for generating images using Kandinsky API.
Basic Info
- Host: GitHub
- Owner: ai-forever
- License: mit
- Language: Python
- Default Branch: main
- Size: 22.5 KB
Statistics
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
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:
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 в рабочей директории проекта.
Описание инструмента
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 для подробностей.
Owner
- Name: AI Forever
- Login: ai-forever
- Kind: organization
- Location: Armenia
- Repositories: 60
- Profile: https://github.com/ai-forever
Creating ML for the future. AI projects you already know. We are non-profit organization with members from all over the world.
GitHub Events
Total
- Watch event: 1
- Member event: 1
- Push event: 1
- Fork event: 1
- Create event: 2
Last Year
- Watch event: 1
- Member event: 1
- Push event: 1
- Fork event: 1
- Create event: 2
Committers
Last synced: about 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Sergei Trashchenkov | t****v@g****m | 3 |
Issues and Pull Requests
Last synced: 12 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 16 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 2
- Total maintainers: 1
pypi.org: mcp_kandinsky
MCP сервер для генерации изображений через Kandinsky API
- Homepage: https://github.com/ai-forever/mcp_kandinsky
- Documentation: https://mcp_kandinsky.readthedocs.io/
- License: MIT
-
Latest release: 0.2.0
published about 1 year ago