mcp-vsepgt

MCP серверы для VseGPT предоставляют стандартизированный интерфейс для доступа к внешним данным и функциям через модели. mcp_gen_image генерирует изображения посредством VseGPT и сохранением файлов в папке скрипта / tmp_images, а mcp_gen_tts обеспечивает генерацию речи через VseGPT и воспроизведение через MPC-HC. Оба сервера требуют настройки ключа VSEGPT_API_KEY. После запуска сервера вы сможете взаимодействовать с этими функциями через интерфейс MCP, добавляя соответствующие инструменты в контекст модели без перегрузки общего поля tools.

prerequisites: Python 3.8+

• Установить Python и pip
• Установить пакет fastmcp (как глобально, так и в виртуальном окружении)

Шаги установки:

1. Установите виртуальное окружение (опционально, рекомендуется): python -m venv venv source venv/bin/activate # Linux/macOS .\venv\Scripts\activate # Windows
2. Установите fastmcp: pip install fastmcp==0.4.1
3. Сохраните скрипты mcp_gen_image.py и mcp_gen_tts.py рядом с рабочей директорией или в доступном месте.
4. Убедитесь, что переменные окружения корректно настроены (см. ниже) и запустите сервера из соответствующей директории.

Пример запуска (настроенный как модуль Python):

python -m fastmcp run mcp_gen_image.py

или для TTS:

python -m fastmcp run mcp_gen_tts.py

Примечание: В README указано, что для работы требуется пакет fastmcp версии 0.4.1 на момент запуска. Установите совместимую версию.

Полезные подсказки:

• В mcp_gen_image.py обязательна переменная окружения VSEGPT_API_KEY. Без нее генерация невозможна.
• IMG_MODEL_ID и IMG_SIZE являются опциональными; задавайте их при необходимости, чтобы управлять моделью и разрешением.
• В mcp_gen_tts.py также необходим VSEGPT_API_KEY; дополнительных параметров копирования или настройки может не потребоваться.
• Файлы выводов (например, изображения) сохраняются в папке скрипта / tmp_images; убедитесь, что у процесса есть права записи в эту директорию.
• Если используете виртуальное окружение, активируйте его перед запуском сервера.
• При обновлениях зависимостей проверяйте совместимость с fastmcp 0.4.1 и совместимость Python версии.