Yandex AI Studio Server

License: MIT Python 3.11+ MCP

MCP-сервер для полного доступа AI-агентов к Yandex Cloud AI Studio: языковые модели, генерация изображений, синтез речи, эмбеддинги, классификация, CRM-автоматизация.

AI-агент через стандартный Model Context Protocol получает более 20 инструментов — от чата с YandexGPT до создания сделок в Bitrix24, amoCRM и RetailCRM. Плюс уникальная возможность: агент может создавать и запускать других AI-агентов для бизнес-задач.

Возможности

AI & ML

Инструмент	API	Назначение
chat	YandexGPT Pro/Lite	OpenAI-совместимый чат с function calling
completion	YandexGPT	Простая текстовая генерация
generate_image	YandexART	Генерация изображений (1024×1024)
speech_to_text	SpeechKit STT	Распознавание речи (ru-RU, en-US, kk-KK, tr-TR)
text_to_speech	SpeechKit TTS	Синтез речи (oksana, jane, omazh, zahar, ermil)
get_embeddings	Embeddings API	Векторные эмбеддинги для поиска/RAG
classify_text	YandexGPT Classifier	Классификация: sentiment, topic, intent
list_models	—	Список доступных моделей

AI-агенты (ключевая фича)

Инструмент	Описание
create_agent	Создать AI-агента с системным промптом и инструментами
run_agent	Запустить агента с задачей (многошаговый function calling)
list_agents	Список созданных агентов

Агенты сохраняются в ./agents/ и переиспользуются. run_agent реально выполняет CRM-вызовы — не эмулирует.

Поисковые индексы

Инструмент	Описание
create_search_index	Создать индекс (текстовый, векторный, гибридный)
search_in_index	Поиск по индексу

CRM-автоматизация

Инструмент	CRM	Операция
create_amocrm_lead	amoCRM	Создать сделку с контактом
find_amocrm_contact	amoCRM	Поиск контакта
create_amocrm_task	amoCRM	Создать задачу
create_bitrix_lead	Bitrix24	Создать лид
create_bitrix_deal	Bitrix24	Создать сделку
search_bitrix_contacts	Bitrix24	Поиск контактов
create_retailcrm_order	RetailCRM	Создать заказ
search_retailcrm_orders	RetailCRM	Найти заказы клиента

CRM-инструменты опциональны — работают только с соответствующими ключами в .env.

Быстрый старт

1. Установка

git clone https://github.com/rusnetru/yandex-ai-studio-mcp-server.git
cd yandex-ai-studio-mcp-server
pip install -r requirements.txt

2. Конфигурация

Создайте .env:

YANDEX_FOLDER_ID=b1gxxxxxxxxxxxxxxxxxxxxxxxxx
YANDEX_API_KEY=AQVNxx...

# Опционально — CRM
AMOCRM_SUBDOMAIN=yourcompany
AMOCRM_ACCESS_TOKEN=...
BITRIX24_WEBHOOK=https://your.bitrix24.ru/rest/1/token/
RETAILCRM_DOMAIN=yourcompany
RETAILCRM_API_KEY=...

3. Подключение к Claude Desktop

{
  "mcpServers": {
    "yandex-ai-studio": {
      "command": "python",
      "args": ["D:/MSP Servers/Yandex AI Studio MCP Server/server.py"],
      "env": {
        "YANDEX_FOLDER_ID": "b1g...",
        "YANDEX_API_KEY": "AQVN..."
      }
    }
  }
}

4. Подключение к Hermes Agent

mcp_servers:
  yandex-ai-studio:
    command: "python"
    args: ["D:/MSP Servers/Yandex AI Studio MCP Server/server.py"]
    env:
      YANDEX_FOLDER_ID: "b1g..."
      YANDEX_API_KEY: "AQVN..."
    timeout: 120

Пример: AI-агент техподдержки

# Агент создаёт другого агента:
→ create_agent(
    name="SupportBot",
    system_prompt="Ты агент техподдержки. При проблемах с заказом — ищи в RetailCRM.",
    tools=["search_retailcrm_orders"]
)

# Запускает с задачей:
→ run_agent(
    agent_id="SupportBot_abc123",
    task="Клиент +79991234567 не получил заказ #12345. Найди заказ и объясни статус."
)

# Агент сам вызывает CRM, находит заказ, формулирует ответ.

Модели YandexGPT

Модель	Контекст	Назначение
yandexgpt	8K	Основная Pro-модель
yandexgpt-lite	8K	Быстрая/лёгкая
yandexgpt-32k	32K	Длинные документы

Требования

• Python 3.11+
• Yandex Cloud аккаунт + API-ключ (или IAM-токен)
• Для CRM: соответствующие учётные записи

Лицензия

MIT