# VseGPT MCP Servers

Здесь будет набор MCP серверов для VseGPT, написанных на Python

MCP (Model Context Protocol) - это протокол взаимодействия между языковыми моделями и внешними контекстными серверами. Основные задачи MCP:

- Предоставление моделям доступа к актуальным данным и знаниям через API
- Возможность выполнения действий в реальном мире (отправка email, работа с файлами и т.д.)
- Обеспечение безопасности при работе с внешними системами

MCP серверы работают как промежуточный слой между языковыми моделями и внешними сервисами/данными, предоставляя стандартизированный интерфейс для взаимодействия.

## Инсталляция

Для работы используется Python + [fastmcp package](https://github.com/jlowin/fastmcp) (на момент запуска - версия 0.4.1)

## Логика

Разные функции VseGPT обычно будут представлены в разных серверах, не в одном. 
Это позволит динамически включать и выключать функциональность, предоставляемую моделям в поле tools, 
не перегружая это поле, контекст модели, и не запутывая её. 

## Сервера

### mcp_gen_image.py

Сервер для генерации картинок через VseGPT.

Файлы сохраняются в папке скрипта / tmp_images

Запускается как: `fastmcp run mcp_gen_image.py`

Параметры окружения:
- VSEGPT_API_KEY=ваш_ключ_vsegpt (обязательно)
- IMG_MODEL_ID=ID модели генерации изображений на сайте VseGPT (опционально, по умолчанию `img-dummy/image`)
- IMG_SIZE=размер генерации (опционально, по умолчанию `1024x1024`)

Пример настройки можно найти здесь: https://vsegpt.ru/ExtTools/CherryStudio

### mcp_gen_tts.py

**(Бета, настраивайте самостоятельно через код при необходимости)**

Сервер для генерации речи через VseGPT

Файлы сохраняются в папке скрипта / tmp_images. По получении запускается MPC-HC на проигрывание звука.

Запускается как: `fastmcp run mcp_gen_tts.py`

Параметры окружения:
- VSEGPT_API_KEY=ваш_ключ_vsegpt (обязательно)