Перейти к основному содержимому
Открыть Markdown

Собственные серверы

Собственный сервер Hosted MCP создается из указанного вами определения пакета или процесса. Just Run запускает его как управляемый сервис в среде выполнения Hosted MCP текущей инсталляции, публикует /mcp за bearer-токеном инстанса и проверяет MCP handshake перед переводом поколения в ready.

Если курируемый каталог не содержит нужного сервера, откройте в форме Новый MCP-сервер вкладку Свой сервер.

Ментальная модель​

npx package ───┐
uvx package ───┼──► stdio MCP process ──► Streamable HTTP bridge ──► /mcp
command argv ──┘

http command + port ──► native Streamable HTTP server ─────────────► /mcp

Тип источника определяет компиляцию сервиса, и его нельзя изменить после создания инстанса. Пакет, версию, аргументы, команду и порт можно редактировать там, где они применимы; выполните развертывание измененного определения, чтобы заменить работающее поколение.

Требования к источникам​

ИсточникОбязательное определениеЧто запускает Just Run
npxnpm-пакетnpx -y <package> с аргументами
uvxPython-пакетuvx <package> с аргументами
commandНепустая команда с аргументамиЭта команда как stdio-процесс MCP
httpНепустая команда с аргументами и порт 1..65535Эта команда напрямую, без моста протоколов

npx, uvx и command должны реализовывать MCP через stdio. Just Run оборачивает их мостом без сохранения состояния, публикующим Streamable HTTP. Источник http должен самостоятельно предоставлять Streamable HTTP по /mcp на указанном порту.

Пакетные источники​

Для npx и uvx укажите имя пакета и необязательную версию:

npx: @scope/package + 1.2.3  →  npx -y '@scope/package@1.2.3'
uvx: package-name + 1.2.3 → uvx 'package-name==1.2.3'

Без версии каждое новое развертывание разрешает последнюю версию, доступную менеджеру пакетов в этот момент. Фиксируйте версию, когда важна повторяемость поколений; для изменения зафиксированной версии требуется повторное развертывание.

Текущий образ среды выполнения рассчитан на Node.js, npx, Python, uvx, supergateway, Git и распространенные инструменты командной строки. Конкретный образ и его содержимое — конфигурация инсталляции, а не переносимый публичный контракт среды выполнения.

Установка пакета происходит во время запуска новой песочницы, в которой работает сервер. Поэтому доступность реестра пакетов, изменения издателя, удаленные релизы, скрипты установки и разрешение зависимостей могут повлиять на длительность развертывания или сломать последующее повторное развертывание.

Аргументы​

Аргументы передаются после спецификации пакета. В веб-интерфейсе поле Аргументы в разделе Запуск формы разбивается по пробельным символам:

--flag value --verbose

Получаются три аргумента: --flag, value и --verbose. REST API принимает явный массив args и может сохранить один аргумент с пробелами. Just Run заключает каждый аргумент в кавычки перед передачей через мост stdio.

Источник command​

Используйте command для исполняемого файла, уже доступного в настроенной среде выполнения Hosted MCP. В веб-интерфейсе вводите по одному элементу команды на строку:

python3
-m
my_mcp_server

Первая строка — исполняемый файл, остальные — его аргументы. Значения считаются отдельными элементами команды и по отдельности заключаются в кавычки. Не вводите скрипт оболочки, конвейер, перенаправление, подстановку переменных или единую командную строку с пробелами.

command не загружает исходный код и не собирает приложение. Если процесс зависит от файлов или исполняемых файлов, которых нет в образе среды выполнения, используйте пакетный источник или подготовьте рабочую нагрузку в обычной песочнице.

Источник http​

Используйте http только для процесса, который уже реализует MCP Streamable HTTP. Укажите:

  • по одному элементу команды на строку;
  • порт, который слушает процесс;
  • необходимые значения переменных окружения процесса.

Just Run напрямую запускает команду, ждет объявленный порт и публикует стабильный URL, защищенный bearer-токеном и оканчивающийся на /mcp. Он не преобразует другой HTTP-путь или протокол в MCP. Процесс должен привязаться к адресу, доступному для прокси сервисов песочницы, и отвечать на MCP-запросы initialize и tools/list по /mcp.

Границы валидации​

  • Пакетные источники требуют непустое имя пакета только из букв ASCII, цифр и символов @, /, ., _, -, =, ^, ~.
  • Фиксация версии доступна только для npx и uvx: не более 64 букв ASCII, цифр и символов ., _, +, -.
  • command и http отклоняют пустые элементы команды.
  • http требует целочисленный порт от 1 до 65535.
  • Имена переменных окружения могут содержать буквы ASCII, цифры и _ и иметь длину до 128 символов.

Успешная валидация определения означает только то, что Just Run может скомпилировать сервис. Развертывание все еще может завершиться ошибкой во время установки пакета, запуска процесса, ожидания порта, открытия внешнего доступа или MCP handshake.

За код сервера отвечаете вы

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