@theyahia/gigachat-mcp

MCP-сервер для Sber GigaChat API — генерация текста, список моделей, эмбеддинги, подсчёт токенов, суммаризация. 6 инструментов.

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop

{
  "mcpServers": {
    "gigachat": {
      "command": "npx",
      "args": ["-y", "@theyahia/gigachat-mcp"],
      "env": {
        "GIGACHAT_CLIENT_ID": "your-client-id",
        "GIGACHAT_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

claude mcp add gigachat \
  -e GIGACHAT_CLIENT_ID=your-client-id \
  -e GIGACHAT_CLIENT_SECRET=your-client-secret \
  -- npx -y @theyahia/gigachat-mcp

VS Code / Cursor

{
  "servers": {
    "gigachat": {
      "command": "npx",
      "args": ["-y", "@theyahia/gigachat-mcp"],
      "env": {
        "GIGACHAT_CLIENT_ID": "your-client-id",
        "GIGACHAT_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Streamable HTTP

GIGACHAT_CLIENT_ID=... GIGACHAT_CLIENT_SECRET=... npx @theyahia/gigachat-mcp --http
# Endpoint: http://localhost:3000/mcp
# Health:   http://localhost:3000/health

Аутентификация

Три варианта (в порядке приоритета):

Переменная	Описание
`GIGACHAT_API_KEY`	Bearer-токен (без OAuth, используется напрямую)
`GIGACHAT_CLIENT_ID` + `GIGACHAT_CLIENT_SECRET`	OAuth 2.0 client credentials — токен обновляется автоматически
`GIGACHAT_AUTH_KEY`	Base64 от `client_id:client_secret` (legacy, обратная совместимость)

Как получить ключ

Зарегистрируйтесь на developers.sber.ru
Создайте проект и подключите API GigaChat
В разделе "Авторизационные данные" скопируйте Client ID и Client Secret
Scope: GIGACHAT_API_PERS (для физлиц), GIGACHAT_API_CORP (для юрлиц)

Сертификаты Сбера

GigaChat API использует сертификаты Минцифры РФ. Если Node.js не доверяет им по умолчанию:

# Вариант 1: отключить проверку (только для разработки!)
NODE_TLS_REJECT_UNAUTHORIZED=0 npx @theyahia/gigachat-mcp

# Вариант 2: добавить корневой сертификат Минцифры
# Скачайте с https://www.gosuslugi.ru/crt и укажите:
NODE_EXTRA_CA_CERTS=/path/to/russian-trusted-root.pem npx @theyahia/gigachat-mcp

Инструменты (6)

Инструмент	Описание
`chat_completion`	Генерация текста через GigaChat с поддержкой диалога
`list_models`	Список доступных моделей GigaChat
`get_embeddings`	Получение векторных представлений текстов
`token_count`	Подсчёт токенов в текстах
`generate`	Простая генерация: промпт → текст (skill)
`summarize`	Суммаризация текста (skill)

Примеры

Сгенерируй текст через GigaChat: "Напиши стихотворение о весне"
Суммаризируй текст через GigaChat: "Длинный текст..."
Покажи список доступных моделей GigaChat
Получи эмбеддинги для текстов ["Привет", "Мир"]
Посчитай токены в тексте "Привет, мир!"

Разработка

npm install
npm test          # Vitest
npm run build     # TypeScript → dist/
npm run dev       # tsx watch mode

Лицензия

MIT

gigachat-mcp

Quick Install