About yandexgpt-mcp
yandexgpt-mcp exposes YandexGPT API operations for text generation, embeddings, classification, summarization, and tokenization. It is for MCP clients that need these language-processing functions, and development has moved to theYahia/YaAll.
Key features
- 01Generate text synchronously or asynchronously
- 02Check asynchronous operation status
- 03Create text and document embeddings
- 04Classify text using labels
- 05Summarize text
- 06Tokenize text and count tokens
Use cases
- 01Generate text with YandexGPT
- 02Track a long-running generation request
- 03Create embeddings for product descriptions
- 04Classify a customer review
- 05Summarize an article and count its tokens
MCP support
Provides eight YandexGPT API tools to MCP clients, covering generation, operation checks, embeddings, classification, summarization, and tokenization.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
8Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | No | Model (yandexgpt-lite, yandexgpt, yandexgpt-32k) |
| messages | array | Yes | Массив сообщений диалога |
| maxTokens | integer | No | Максимальное количество токенов |
| temperature | number | No | Generation temperature (0–1) |
Details
From the project README🗄 Репозиторий заархивирован
Разработка переехала в theYahia/YaAll — сборку, где весь яндексовский слой лежит в одном месте: свои MCP-серверы, скиллы Claude Code и материалы официальных наборов Яндекса.
Актуальная версия того, что лежало здесь:
mcp/yandexgpt-mcp/Пакет в npm прежний —
@theyahia/yandexgpt-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в YaAll.Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at
mcp/yandexgpt-mcp/. The npm package@theyahia/yandexgpt-mcpis unchanged. Please open issues and pull requests there.
Этот сервер входит в сборку theYahia/YaAll — весь яндексовский слой в одном репозитории: десять MCP-серверов, скиллы Claude Code под SEO и валидацию спроса, плюс материалы официальных серверов Яндекса. Здесь он живёт отдельно, там — рядом с остальными:
mcp/yandexgpt-mcp/Part of theYahia/YaAll — the whole Yandex stack in one repo.
@theyahia/yandexgpt-mcp
MCP-сервер для Yandex GPT API — генерация текста, эмбеддинги, классификация, суммаризация, токенизация. 8 инструментов.
Часть серии Russian API MCP (50 серверов) by @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"yandexgpt": {
"command": "npx",
"args": ["-y", "@theyahia/yandexgpt-mcp"],
"env": { "YANDEX_API_KEY": "your-api-key", "YANDEX_FOLDER_ID": "your-folder-id" }
}
}
}
Claude Code
claude mcp add yandexgpt -e YANDEX_API_KEY=your-api-key -e YANDEX_FOLDER_ID=your-folder-id -- npx -y @theyahia/yandexgpt-mcp
VS Code / Cursor
{ "servers": { "yandexgpt": { "command": "npx", "args": ["-y", "@theyahia/yandexgpt-mcp"], "env": { "YANDEX_API_KEY": "your-api-key", "YANDEX_FOLDER_ID": "your-folder-id" } } } }
Требуется
YANDEX_API_KEYиYANDEX_FOLDER_ID. Получите в консоли Yandex Cloud.
Инструменты (8)
| Инструмент | Описание |
|---|---|
complete | Синхронная генерация текста через YandexGPT |
complete_async | Асинхронная генерация, возвращает ID операции |
get_operation | Проверить статус асинхронной операции |
embed_text | Получить эмбеддинг одного текста |
embed_documents | Batch-эмбеддинги для массива текстов |
classify | Zero-shot классификация текста по меткам |
summarize | Суммаризация текста |
tokenize | Токенизация текста, подсчёт токенов |
Демо-промпты
Сгенерируй текст через YandexGPT: "Напиши стихотворение о весне"
Запусти асинхронную генерацию длинного текста и проверь статус операции
Получи эмбеддинг для текста "Машинное обучение"
Получи эмбеддинги для 5 описаний товаров
Классифицируй отзыв "Доставка опоздала на 3 дня" по меткам: позитивный, негативный, нейтральный
Суммаризируй статью из 2000 слов в 3 предложения
Посчитай количество токенов в тексте "Привет, мир!"
Лицензия
MIT
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.