GigaChat Image MCP: картинки Kandinsky из Claude без VPN
GigaChat-image-MCP
Картинки Kandinsky в Claude Code и Desktop через GigaChat API: фоновые задачи, журнал вызовов и подтверждение перед тратой лимита
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Каждая генерация тратит лимит GigaChat, а цикл агента без подтверждений расходует его быстро
- Промпты уходят во внешний сервис Сбера, ключ лежит в файле `key.env`
Установка
- Работает в
- Сервисы
Ручная установка
claude mcp add gigachat-image --scope user -e GIGACHAT_KEY_FILE=C:/path/to/gigachat-image-mcp/key.env -e IMAGE_OUTPUT_DIR=C:/path/to/images -e NODE_EXTRA_CA_CERTS=C:/path/to/gigachat-image-mcp/certs/russian_trusted_ca.pem -- node C:/path/to/gigachat-image-mcp/index.jsПеред этим клонируют репозиторий и выполняют `npm install`; пути заменяют своими, ключ кладут в `key.env`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Каждая генерация тратит лимит GigaChat, а цикл агента без подтверждений расходует его быстро
- Промпты уходят во внешний сервис Сбера, ключ лежит в файле `key.env`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер на Node.js для Claude Code и Claude Desktop рисует картинки по тексту через GigaChat API со встроенной моделью Kandinsky. Два инструмента: `generate_image` создает изображение, сохраняет JPG в папку `IMAGE_OUTPUT_DIR` и возвращает путь к файлу, а `check_image` показывает статус задачи по `job_id` или список последних задач и в Сбер не обращается. Если рисование идет дольше `GIGACHAT_WAIT_MS`, сервер возвращает `job_id`, а генерация продолжается в фоне. В описании `generate_image` Claude обязан спрашивать разрешение перед каждым вызовом, а все вызовы пишутся в `gigachat-image.log`. Ключ читается из файла `GIGACHAT_KEY_FILE`, сертификат НУЦ Минцифры лежит в `certs/` и подключается через `NODE_EXTRA_CA_CERTS`.
Для кого. Пользователям Claude в России, которым нужны иллюстрации для презентаций и документов без иностранных карт и VPN.
Подходит, если
- Claude готовит презентацию, и в слайды надо вставить сгенерированные картинки
- Картинка рисуется долго, и нужно отслеживать задачу по `job_id`, а не ждать в чате
- Регистрация и оплата должны идти через Сбер ID, на бесплатном тарифе для физлиц
- Каждый вызов генерации должен проходить через подтверждение пользователя
Не подходит, если
- Нужны видео, правка готовых картинок или inpainting: сервер только создает новые изображения
- Нужна установка одной командой из npm: сервер ставится клонированием репозитория и `npm install`
- Лимит GigaChat исчерпан: каждая генерация тратит его, а `check_image` ничего не списывает
Пример запроса к агенту
Нарисуй акварельную иллюстрацию «осенний парк» для обложки презентации и вставь путь к JPG в документMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
GIGACHAT_KEY_FILEобязательная- Путь к файлу `key.env` с Authorization Key GigaChat
IMAGE_OUTPUT_DIR- Папка для сохранения JPG
NODE_EXTRA_CA_CERTSобязательная- Путь к сертификату НУЦ Минцифры `russian_trusted_ca.pem`
GIGACHAT_WAIT_MS- Сколько ждать генерацию до возврата `job_id`
Ограничения
Нужны Node.js 20 и новее, ключ авторизации GigaChat API (показывается один раз) и корневой сертификат НУЦ Минцифры из каталога `certs/`; промежуточный сертификат действует до 6 марта 2027 года, потом его надо заменить файлами с Госуслуг. Генерация тратит лимит GigaChat, а на бесплатном тарифе для физлиц лимиты задает Сбер. Подтверждение вызова держится на описании инструмента и на правиле `permissions.ask` в настройках Claude Code. Репозиторий маленький: ноль звезд, последний коммит в ноябре 2026 года, лицензии нет.
Как отключить. Удалите сервер командой `claude mcp remove gigachat-image`, стерите `key.env` и отзовите ключ в кабинете разработчика Сбера.
Частые вопросы
Нужен ли VPN?
Нет: по README регистрация идет через Сбер ID, есть бесплатный режим для физических лиц, иностранные карты не требуются.
Почему нужен сертификат?
Серверы Сбера используют сертификат российского удостоверяющего центра, которому Node.js по умолчанию не доверяет; файл лежит в `certs/` и подключается через `NODE_EXTRA_CA_CERTS`.
Что делать, если картинка рисуется долго?
Сервер вернет `job_id`, генерация продолжится в фоне, а статус покажет `check_image`.
Как заставить Claude спрашивать разрешение?
Добавить в `~/.claude/settings.json` правило `permissions.ask` для `mcp__gigachat-image__generate_image`.
Где лежат готовые картинки?
В папке из `IMAGE_OUTPUT_DIR` в виде JPG; путь к файлу сервер возвращает в ответе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
GigaChat — все инструментыGigaChat: генерация изображений через MCP
mcp-server-gigachat-image-generation
MCP-сервер в Docker-образе для генерации изображений через GigaChat, настраивается ключом GIGACHAT_CREDENTIALS
MCP-сервер генерации изображений через официальный API нейросети Kandinsky от Сбера с выбором стиля и негативным промптом
MCP-сервер для проверки текста на признаки генерации нейросетью через GigaChat API
Неофициальное расширение Chrome добавляет в чат giga.chat кнопку MCP: серверы по адресу, OAuth 2.1, локальные программы и подтверждение каждого вызова
MCP-сервер для API GigaChat
GigaChat API
Небольшой Python MCP-сервер для API GigaChat от Сбера: авторизация по Basic-ключу и обращение к моделям прямо из агента, проверялся на OpenCode под Windows
Прокси от ai-forever, который отдает GigaChat через API OpenAI, Anthropic и Gemini, чтобы запускать на нем Claude Code, Codex и Gemini CLI
Коротко о README
README коротко объясняет назначение, таблицей описывает два инструмента, перечисляет требования, шаги получения ключа GigaChat, работу с сертификатом Минцифры и подключение к Claude Code и Claude Desktop с правилом подтверждения вызовов.