Собственные серверы
Собственный сервер 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 |
|---|---|---|
npx | npm-пакет | npx -y <package> с аргументами |
uvx | Python-пакет | 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.
Собственные пакеты и команды запускаются под вашим аккаунтом и получают переменные окружения открытым текстом, доступные сервису. Изоляция песочницы ограничивает границу выполнения, но не делает сторонний код доверенным. Проверяйте источник и издателя, при необходимости фиксируйте зависимости и используйте учетные данные с минимальными правами.