About gigachat-mcp
gigachat-mcp exposes Sber GigaChat API capabilities to MCP clients through eight tools. It covers chat, embeddings, image generation, token and account information, assistants, and file upload; development has moved to the WWmcp monorepo.
Key features
- 01Generate conversational text
- 02List available models
- 03Create text embeddings
- 04Count text tokens
- 05Generate images
- 06Check balance and list assistants
- 07Upload files for multimodal processing
Use cases
- 01Generate text with GigaChat
- 02Create embeddings or count tokens for text
- 03Generate images from a request
- 04Upload a file for multimodal processing
MCP support
Exposes GigaChat API operations as eight tools for MCP clients, including chat, embeddings, image generation, and file upload.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
8Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | No | GigaChat model (GigaChat, GigaChat-Plus, GigaChat-Pro) |
| top_p | number | No | Top-p sampling |
| messages | array | Yes | Массив сообщений диалога |
| max_tokens | integer | No | Максимальное количество токенов |
| temperature | number | No | Температура генерации (0–2) |
Details
From the project README🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/gigachat/Пакет в npm прежний —
@theyahia/gigachat-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/gigachat/. The npm package@theyahia/gigachat-mcpis unchanged. Please open issues and pull requests there.
@theyahia/gigachat-mcp
MCP-сервер для Sber GigaChat API — чат, эмбеддинги, генерация изображений, подсчёт токенов, баланс, ассистенты, файлы. 8 инструментов.
Часть серии Russian API MCP (50 серверов) by @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"gigachat": {
"command": "npx",
"args": ["-y", "@theyahia/gigachat-mcp"],
"env": { "GIGACHAT_AUTH_KEY": "your-auth-key" }
}
}
}
Claude Code
claude mcp add gigachat -e GIGACHAT_AUTH_KEY=your-auth-key -- npx -y @theyahia/gigachat-mcp
VS Code / Cursor
{ "servers": { "gigachat": { "command": "npx", "args": ["-y", "@theyahia/gigachat-mcp"], "env": { "GIGACHAT_AUTH_KEY": "your-auth-key" } } } }
Требуется
GIGACHAT_AUTH_KEY(Base64-encodedclient_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 | Загрузка файла для мультимодальной обработки |
Демо-промпты
Спроси GigaChat: "Напиши стихотворение о весне"
Покажи список доступных моделей GigaChat
Получи эмбеддинги для текстов ["Привет", "Мир"]
Посчитай токены в тексте "Привет, мир!"
Нарисуй через GigaChat котика в шляпе
Покажи баланс GigaChat
Загрузи файл в GigaChat для анализа
Лицензия
MIT
Telegram: @vhodvai
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.