io.github.theYahia/gigachat-mcp

Official

by theYahia · TypeScript

gigachat-mcp

MCP server for GigaChat — AI chat, embeddings, image generation (Russia)

Provides AI chat, embeddings, and image generation via GigaChat.

Topics

aiclaudegigachatllmmcpmcp-servermodel-context-protocolrussian-apitypescriptapi

README.md3 KBView on GitHub

@theyahia/gigachat-mcp

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

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

Установка

Claude Desktop

json

{
  "mcpServers": {
    "gigachat": {
      "command": "npx",
      "args": ["-y", "@theyahia/gigachat-mcp"],
      "env": { "GIGACHAT_AUTH_KEY": "your-auth-key" }
    }
  }
}

Claude Code

bash

claude mcp add gigachat -e GIGACHAT_AUTH_KEY=your-auth-key -- npx -y @theyahia/gigachat-mcp

VS Code / Cursor

json

{ "servers": { "gigachat": { "command": "npx", "args": ["-y", "@theyahia/gigachat-mcp"], "env": { "GIGACHAT_AUTH_KEY": "your-auth-key" } } } }

Требуется GIGACHAT_AUTH_KEY (Base64-encoded client_id:client_secret). Получите на developers.sber.ru. Токены OAuth обновляются автоматически.

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

Инструмент	Описание
`chat`	Генерация текста через GigaChat с диалогом
`list_models`	Список доступных моделей
`embed_text`	Получение эмбеддингов текстов
`get_token_count`	Подсчёт токенов для текстов
`generate_image`	Генерация изображения через GigaChat
`get_balance`	Остаток токенов/квоты
`list_assistants`	Список ассистентов
`file_upload`	Загрузка файла для мультимодальной обработки

Демо-промпты

code

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

Лицензия

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "gigachat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/gigachat-mcp@3.0.1"
      ]
    }
  }
}