Skip to main content
Glama
README.md
> ## 🗄 Репозиторий заархивирован
>
> Разработка переехала в **[theYahia/YaAll](https://github.com/theYahia/YaAll)** — сборку, где весь яндексовский слой лежит в одном месте: свои MCP-серверы, скиллы Claude Code и материалы официальных наборов Яндекса.
>
> Актуальная версия того, что лежало здесь: [`mcp/yandexgpt-mcp/`](https://github.com/theYahia/YaAll/tree/main/mcp/yandexgpt-mcp)
>
> Пакет в npm прежний — [`@theyahia/yandexgpt-mcp`](https://www.npmjs.com/package/@theyahia/yandexgpt-mcp), ставится и работает как раньше.
> Здесь больше ничего не обновляется. Задачи и pull request'ы — в YaAll.
>
> **Archived — development moved to [theYahia/YaAll](https://github.com/theYahia/YaAll),** a single repository bundling the whole Yandex stack.
> The current version of this package now lives at [`mcp/yandexgpt-mcp/`](https://github.com/theYahia/YaAll/tree/main/mcp/yandexgpt-mcp).
> The npm package [`@theyahia/yandexgpt-mcp`](https://www.npmjs.com/package/@theyahia/yandexgpt-mcp) is unchanged.
> Please open issues and pull requests there.

> Этот сервер входит в сборку **[theYahia/YaAll](https://github.com/theYahia/YaAll)** —
> весь яндексовский слой в одном репозитории: десять MCP-серверов, скиллы Claude Code
> под SEO и валидацию спроса, плюс материалы официальных серверов Яндекса.
> Здесь он живёт отдельно, там — рядом с остальными: [`mcp/yandexgpt-mcp/`](https://github.com/theYahia/YaAll/tree/main/mcp/yandexgpt-mcp)
>
> *Part of [theYahia/YaAll](https://github.com/theYahia/YaAll) — the whole Yandex stack in one repo.*

# @theyahia/yandexgpt-mcp

MCP-сервер для Yandex GPT API — генерация текста, эмбеддинги, классификация, суммаризация, токенизация. **8 инструментов.**

[![npm](https://img.shields.io/npm/v/@theyahia/yandexgpt-mcp)](https://www.npmjs.com/package/@theyahia/yandexgpt-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Часть серии [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 серверов) by [@theYahia](https://github.com/theYahia).

## Установка

### Claude Desktop

```json
{
  "mcpServers": {
    "yandexgpt": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandexgpt-mcp"],
      "env": { "YANDEX_API_KEY": "your-api-key", "YANDEX_FOLDER_ID": "your-folder-id" }
    }
  }
}
```

### Claude Code

```bash
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

```json
{ "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](https://console.cloud.yandex.ru/).

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

| Инструмент | Описание |
|------------|----------|
| `complete` | Синхронная генерация текста через YandexGPT |
| `complete_async` | Асинхронная генерация, возвращает ID операции |
| `get_operation` | Проверить статус асинхронной операции |
| `embed_text` | Получить эмбеддинг одного текста |
| `embed_documents` | Batch-эмбеддинги для массива текстов |
| `classify` | Zero-shot классификация текста по меткам |
| `summarize` | Суммаризация текста |
| `tokenize` | Токенизация текста, подсчёт токенов |

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

```
Сгенерируй текст через YandexGPT: "Напиши стихотворение о весне"
Запусти асинхронную генерацию длинного текста и проверь статус операции
Получи эмбеддинг для текста "Машинное обучение"
Получи эмбеддинги для 5 описаний товаров
Классифицируй отзыв "Доставка опоздала на 3 дня" по меткам: позитивный, негативный, нейтральный
Суммаризируй статью из 2000 слов в 3 предложения
Посчитай количество токенов в тексте "Привет, мир!"
```

## Лицензия

MIT

TDQS

A3.5/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: synchronous generation, asynchronous generation, status checking, single embedding, batch embeddings, classification, summarization, and tokenization. No overlap or ambiguity.

Naming Consistency5/5

All tool names follow a consistent snake_case verb_noun pattern (e.g., complete_async, get_operation, embed_documents). No mixing of conventions or vague verbs.

Tool Count5/5

8 tools is well-scoped for a language model server, covering generation, embeddings, classification, summarization, and tokenization without excess or deficiency.

Completeness4/5

Core functionalities are covered, including both sync and async generation with status tracking, embeddings, classification, summarization, and tokenization. Minor gaps like lack of cancellation for async operations or model listing.

Maintenance

ActivitySlowing
ResponsivenessNo issues