MCP сервер для нейросетей и AI-агентов

NexusAPI MCP — локальный MCP-сервер для AI-агентов: каталог моделей, схемы, запуск генерации изображений и видео и проверка задач через один ключ.

Что такое NexusAPI MCP

NexusAPI MCP — локальный MCP-сервер для нейросетей и AI-агентов. Он связывает совместимый агентный клиент с существующим REST API NexusAPI и представляет операции API как понятные инструменты. Агент может запросить каталог моделей, получить точную схему выбранной модели, подготовить генерацию изображения или видео и проверить состояние асинхронной задачи. Для всех операций используется один ключ NexusAPI.

MCP означает Model Context Protocol. Протокол задаёт единый способ описывать инструменты и их входные параметры, поэтому пользователю не нужно вручную копировать HTTP-запрос в каждый промпт. MCP не является отдельной нейросетью, новым поставщиком моделей или отдельным платным тарифом. Источниками истины остаются публичный каталог NexusAPI и OpenAPI-схема.

Инструменты MCP-сервера

nexusapi_list_models

Возвращает актуальный каталог и позволяет искать модели генерации изображений или видео. Чтение каталога не создаёт платную задачу.

nexusapi_get_model_schema

Находит схему для model_name в OpenAPI. Агент получает обязательные поля, типы и ограничения до формирования запроса, а не предполагает параметры по памяти.

nexusapi_generate

Создаёт асинхронную задачу через POST /generate. Это платное действие, которое может списать средства с баланса. Агент должен сначала показать пользователю модель и параметры и получить явное подтверждение.

nexusapi_get_task

Проверяет задачу через GET /tasks/{task_id}. Статусы queued, pending и processing означают, что нужно подождать; completed содержит результат, failed — информацию об ошибке.

Безопасное подключение к AI-агенту

Для запуска нужен Node.js 20 или новее. Ключ передаётся локальному процессу через переменную окружения NEXUS_API_KEY. Не помещайте токен в промпт, браузерный JavaScript, публичный репозиторий или сообщение поддержки. MCP-сервер работает через stdio. Публичный удалённый endpoint /mcp в текущей версии не заявляется.

Рекомендуемый порядок работы состоит из четырёх шагов. Сначала агент получает каталог и сравнивает модели. Затем запрашивает схему конкретного model_name. После этого показывает пользователю итоговые параметры и предупреждает о платном запуске. Только после подтверждения создаётся задача. Полученный task_id сохраняется и проверяется с разумным интервалом без агрессивного polling.

Для production-сценария дополнительно задайте лимит расходов, ограничьте число повторов и записывайте task_id. Таймаут не всегда означает, что задача не была создана, поэтому нельзя автоматически запускать дубликат без проверки результата. При обработке пользовательских файлов также проверьте права на исходные изображения и видео.

Модели изображений и видео через MCP

Один MCP-сервер может работать с разными семействами из каталога NexusAPI. Для изображений доступны Nano Banana API и GPT Image API. Для видео изучите Kling API, Seedance 2 API, Veo 3 API, Sora API и Minimax API. MCP отвечает за общий способ вызова инструментов, а поля конкретной генерации определяются схемой model_name.

Поисковые формулировки Nano Banana MCP, Kling MCP, Veo MCP, Seedance MCP и GPT Image MCP описывают доступ к соответствующим моделям через общий сервер NexusAPI. Это не разные установки и не разные ключи. Доступ без VPN для пользователей из России является дополнительным удобством, а не основным назначением MCP и не обещанием бесплатных генераций.

Все модели NexusAPI с подключением через MCP

Каждая ссылка ведёт на единственную каноническую страницу модели с REST API и MCP-инструкцией. Отдельные дубли страниц только ради замены слова API на MCP не создаются.

Стоимость и ограничения

Открытый код локального MCP-сервера можно скачать и протестировать без отдельной подписки. Запросы каталога и схем не запускают генерацию. Сама генерация изображений и видео оплачивается по действующим ставкам NexusAPI. Итог зависит от модели и её параметров; перед вызовом сверяйте цены и каталог.

MCP помогает агенту использовать API последовательно, но не гарантирует место в поисковой выдаче, качество конкретной генерации или доступность каждой модели в любой момент. При разработке опирайтесь на актуальную документацию, обрабатывайте HTTP-ошибки и сохраняйте безопасный диагностический контекст без секретного ключа.

Открыть исходный код NexusAPI MCP на GitHub