Документация MCPBox

Русский

English

Русский

English

Appearance

Установка и первый запуск ​

1. Скачайте MCPBox ​

Откройте релизы на GitHub и выберите файл для своей системы и архитектуры: macOS, Linux или Windows; ARM64 или AMD64 (x64).

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

На macOS и Linux разрешите выполнение скачанного файла и запустите его, используя фактическое имя:

bash
chmod +x ./MCPBox-macos-arm64
./MCPBox-macos-arm64

На Windows запустите скачанный .exe из терминала. В дальнейших примерах предполагается имя MCPBox (на Windows — MCPBox.exe).

2. Создайте первого администратора ​

При первом запуске в интерактивном терминале MCPBox запросит email, отображаемое имя и пароль. Пароль должен содержать не менее восьми символов.

Для службы или другого запуска без интерактивного ввода создайте аккаунт заранее:

bash
./MCPBox admin create --email admin@example.com --password 'replace-with-a-unique-password'
./MCPBox

Команда создаёт или обновляет локального администратора с указанным email. Чтобы вводить пароль без передачи в аргументе команды, используйте интерактивный первый запуск.

3. Войдите в панель ​

Откройте http://127.0.0.1:38181/ и введите данные созданного аккаунта. Сервис без аккаунта может запуститься, но для работы с панелью всё равно потребуется создать администратора.

4. Подключите первый проект ​

  1. Создайте проект с понятным названием.
  2. Добавьте MCP-сервер вручную или через Маркет. Поддерживаются проекты только с CLI или подключёнными Skills.
  3. Выполните проверку работоспособности сервера и устраните ошибки.
  4. Скопируйте MCP-адрес проекта из интерфейса. По умолчанию он использует порт 38182.
  5. Укажите адрес в MCP-настройках ИИ-клиента. Если включена защита, добавьте Bearer-токен проекта.
  6. Обновите список инструментов в клиенте и попробуйте знакомую операцию.

Локальные модели, промпты и OAuth описаны в разделе проектов и подключений.

Сборка из исходников ​

Требуются Go 1.26.9+, Node.js и npm.

bash
git clone https://github.com/ArturSaleev/MCPBox.git
cd MCPBox
npm --prefix html ci
npm --prefix html run build
GOWORK=off go build -o MCPBox .
./MCPBox

Собранный интерфейс встраивается в исполняемый файл. После изменений frontend сначала пересоберите его, затем Go-приложение. Отдельная папка исходников MCPBoxPro больше не нужна.

Если возникла проблема ​

  • Порт занят: остановите конфликтующий процесс или измените порты в настройках.
  • Не получается войти: проверьте email и пароль администратора; при необходимости обновите локальный аккаунт через admin create.
  • Клиент не видит инструменты: проверьте MCP-порт, состояние проекта, включённые серверы, связи CLI и Bearer-защиту.
  • Сервер работает вручную, но не через MCPBox: проверьте путь к программе, аргументы, рабочую папку, переменные окружения и наличие нужного runtime.

При обновлении существующей установки сначала выполните инструкцию обновления.

Проверка загрузки ​

В релизе доступны шесть отдельных бинарников и SHA256SUMS. Скачайте манифест из того же релиза и сравните SHA-256 именно своего файла: shasum -a 256 ./MCPBox-macos-arm64 (macOS), sha256sum ./MCPBox-linux-amd64 (Linux) или Get-FileHash .\MCPBox-windows-amd64.exe -Algorithm SHA256 (PowerShell). Не переименовывайте файл до проверки имени и суммы.

Локальные клиенты работают без Tailscale. Для облачного ChatGPT см. HTTPS, Funnel и OAuth. Для выполнения скриптов Skills нужен работающий Docker на сервере; для чтения инструкций он не требуется.