VseGPT Image Generator

by janvarev

3 stars
261 downloads
Not rated
GitHub

About

Integrates with VseGPT API to generate images from English-language prompts and store them locally with timestamp-based filenames.

Details

Author
janvarev
Repository
janvarev/mcp-vsepgt-server
GitHub stars
3
Downloads
261
License
MIT License
Categories
AI, Developer Tools, File Management, Media, Infrastructure, API, Other
Tags
#mobile

- Image generation via VseGPT API
- Text-to-speech generation (beta)
- Files saved to tmp_images folder
- Modular architecture per function
- Tools can be toggled on/off per server

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name VseGPT Image Generator
    Command (node, npx, python, etc.) fastmcp
    Arguments
    • Argument 1 run
    • Argument 2 mcp_gen_image.py
    Environment
    • IMG_SIZE 1024x1024
    • IMG_MODEL_ID img-dummy/image
    • VSEGPT_API_KEY ваш_ключ_vsegpt

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Python and the fastmcp package (version 0.4.1 at launch). Set the required environment variable VSEGPT_API_KEY. Run a server with the command fastmcp run mcp_gen_image.py or fastmcp run mcp_gen_tts.py. For image generation, optionally set IMG_MODEL_ID (default img-dummy/image) and IMG_SIZE (default 1024x1024).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "vsegpt image generator": {
            "env": {
                "IMG_SIZE": "1024x1024",
                "IMG_MODEL_ID": "img-dummy/image",
                "VSEGPT_API_KEY": "\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_vsegpt"
            },
            "args": [
                "run",
                "mcp_gen_image.py"
            ],
            "command": "fastmcp"
        }
    }
}

Linux

{
    "env": {
        "IMG_SIZE": "1024x1024",
        "IMG_MODEL_ID": "img-dummy/image",
        "VSEGPT_API_KEY": "\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_vsegpt"
    },
    "args": [
        "run",
        "mcp_gen_image.py"
    ],
    "command": "fastmcp"
}

Macos

{
    "env": {
        "IMG_SIZE": "1024x1024",
        "IMG_MODEL_ID": "img-dummy/image",
        "VSEGPT_API_KEY": "\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_vsegpt"
    },
    "args": [
        "run",
        "mcp_gen_image.py"
    ],
    "command": "fastmcp"
}

Windows

{
    "env": {
        "IMG_SIZE": "1024x1024",
        "IMG_MODEL_ID": "img-dummy/image",
        "VSEGPT_API_KEY": "\u0432\u0430\u0448_\u043a\u043b\u044e\u0447_vsegpt"
    },
    "args": [
        "run",
        "mcp_gen_image.py"
    ],
    "command": "fastmcp"
}

VseGPT MCP Servers

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

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

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

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

Инсталляция

Для работы используется Python + fastmcp package (на момент запуска - версия 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 (обязательно)

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.