Русский · English

gigachat-image-mcp

MCP-сервер для Claude (Claude Code и Claude Desktop): генерирует картинки по текстовому описанию через GigaChat API (встроенная модель Kandinsky), сохраняет их в папку как JPG и возвращает путь к файлу. Дальше Claude может вставить картинку в презентацию, документ и т.д.

Работает из России: регистрация через Сбер ID, есть бесплатный режим для физлиц, VPN и иностранные карты не нужны.

Инструменты

В описании generate_image прописано, что Claude обязан перед каждым вызовом спросить разрешение и какую модель взять. Параметр model обязательный:

Рисует всегда Kandinsky: модель только разбирает промпт и ставит ему задачу, а токены списываются из её пакета. Пакет GigaChat-Ultra виден в /balance, но ни одна доступная через API модель из него не списывает, поэтому Ultra в списке нет.

Каждый ответ заканчивается строкой о расходе:

🪙 Потрачено 968 токенов из пакета Max (GigaChat-Max) (точно, по балансу) · текстовая часть 800 → 168 · осталось 24 999 011

Сумма — разница баланса пакета до и после генерации (/balance). Сбер обновляет баланс с задержкой в несколько секунд, поэтому после генерации сервер перезапрашивает его до 8 раз с интервалом 2 с. Если баланс так и не изменился, показывается оценка по usage из ответа модели с пометкой «≈». На практике (проверено 13.11.2026 на Lite/Pro/Max) списание совпадает с usage.total_tokens: картинка отдельно не тарифицируется, одна генерация стоит примерно 900–1500 токенов. Если одновременно шли несколько генераций, сумма помечается как оценка. Все вызовы с расходом пишутся в лог gigachat-image.log.

Related MCP server: MCP Kandinsky

Что понадобится

• Node.js 20 или новее

• Ключ авторизации GigaChat API

• Корневой сертификат НУЦ Минцифры (уже лежит в certs/)

Установка

1. Скачать и установить зависимости

git clone https://github.com/spolperim-lab/gigachat-image-mcp.git
cd gigachat-image-mcp
npm install

2. Получить ключ GigaChat

1. Зайдите на developers.sber.ru через Сбер ID.

2. Создайте проект GigaChat API.

3. «Настроить API» → «Получить ключ» → скопируйте Authorization Key (показывается один раз!).

4. Скопируйте key.env.example в key.env и вставьте ключ в строку Giga_Authorization_Key (старое имя Authorization_Key тоже работает).

⚠️ key.env — это секрет. Не выкладывайте его в интернет и не пересылайте. Он уже добавлен в .gitignore.

3. Сертификат

Серверы Сбера используют сертификат российского удостоверяющего центра, которому Node.js по умолчанию не доверяет. Он лежит в certs/russian_trusted_ca.pem и подключается через переменную NODE_EXTRA_CA_CERTS (см. настройки ниже). Системные настройки Windows менять не нужно.

Промежуточный сертификат действует до 6 марта 2027. Если после этой даты появятся ошибки SELF_SIGNED_CERT_IN_CHAIN или UNABLE_TO_GET_ISSUER_CERT, скачайте свежие russian_trusted_root_ca.cer и russian_trusted_sub_ca.cer с Госуслуг и пересоберите russian_trusted_ca.pem.

4. Подключить к Claude

Во всех примерах замените C:/path/to/gigachat-image-mcp на реальный путь к папке (прямые слэши / работают и в Windows).

Claude Code — команда в терминале:

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

Чтобы Claude Code всегда спрашивал подтверждение перед генерацией, добавьте в ~/.claude/settings.json:

{
  "permissions": {
    "ask": ["mcp__gigachat-image__generate_image"]
  }
}

Claude Desktop — добавьте в claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "gigachat-image": {
      "command": "node",
      "args": ["C:/path/to/gigachat-image-mcp/index.js"],
      "env": {
        "GIGACHAT_KEY_FILE": "C:/path/to/gigachat-image-mcp/key.env",
        "IMAGE_OUTPUT_DIR": "C:/path/to/images",
        "NODE_EXTRA_CA_CERTS": "C:/path/to/gigachat-image-mcp/certs/russian_trusted_ca.pem"
      }
    }
  }
}

После правки полностью перезапустите Claude Desktop (через значок в трее → «Выйти»). Когда Desktop спросит разрешение на инструмент, не выбирайте «Всегда разрешать», если хотите подтверждать каждую генерацию.

Настройки (переменные окружения)

Советы

• Промпт лучше писать подробно и по-русски: объект, стиль, освещение, ракурс, фон, палитра.

• Kandinsky плохо рисует текст на картинках — надписи лучше добавлять в самой презентации.

• Стиль можно задать параметром style, например: «Ты — художник-минималист, рисуешь плоские векторные иллюстрации».

Лицензия

MIT — см. LICENSE.