Skip to content

MCPBox v1.4.0 — Skills & refreshed workspace

Choose a tag to compare

@ArturSaleev ArturSaleev released this 19 Oct 06:40

Highlights

  • Skills library and MCP integration: discover, import and connect versioned Skills to projects; read instructions and resources through MCP.
  • Prepared script execution: process uploaded job files with approved Python, Node.js or Bash scripts in Docker environments configured by an administrator.
  • Light, Dark and System themes across the administration interface.
  • Cleaner Knowledge Base and Settings pages, with contextual help, search dialogs and clearer connection errors.
  • Reorder projects by dragging the sidebar handle, using the up/down buttons or keyboard arrows. The order is remembered per user in the current browser.
  • PolicyBox removal with an explicit migration for affected projects. Read the breaking-change notes before upgrading.

Skills and project integration

  • Browse the catalog with search and category filters; refresh it from a configurable HTTPS source or import catalog JSON. Failed refreshes preserve the last successful snapshot.
  • Import public GitHub Skill directories or ZIP packages, retaining SKILL.md, scripts, references, assets, source and license information. Importing a package does not execute its scripts.
  • Connect specific installed versions to one or more projects. Catalog refreshes do not silently replace installed packages or project bindings.
  • Expose discovery, instruction/resource reading, job creation, input upload, approved execution and output retrieval through project MCP tools. Projects containing only Skills can accept MCP connections.
  • Show Skills tools only when the project has connected Skills; notify active MCP SSE sessions when bindings change. Clients that cache tool catalogs may need a refresh.
  • Fix the list_skills optional-argument schema (required: [] rather than null) for strict action discovery after OAuth, including ChatGPT.
  • Prevent disconnecting a Skill while its project still retains jobs, including jobs that have not run. Save needed files, then remove jobs explicitly.

Server execution and files

Administrators prepare execution profiles, allowed scripts, Docker images, timeouts and optional network access before jobs run. Containers use an unprivileged user, a read-only root filesystem, resource limits and networking disabled by default. Host project directories, the Docker socket and MCPBox environment secrets are not passed to job containers.

Docker must be installed and running on the MCPBox server only for script execution. Browsing, importing and reading Skill instructions work without Docker. Clients must upload actual file bytes; a path on the user's computer is not a file on the MCPBox server. Third-party packages retain their own licenses, and catalog inclusion does not guarantee safety or compatibility.

Skills guide (EN) · Руководство Skills (RU)

Interface and usability

  • Persist the theme choice in the browser; use shared colors for forms, dialogs, status labels, logs and notifications.
  • Keep Knowledge Base cards compact. Open usage help and collection details with !; enter queries and inspect results, loading, empty and error states in one Search dialog.
  • Group Settings into System and Security, with desktop navigation and a compact section selector on smaller screens. Collapse storage diagnostics and show PostgreSQL fields only when selected.
  • Load RagBox catalogs when needed. An unavailable RagBox service produces an explanation, Retry and expandable technical details inside its section, instead of unrelated startup error notifications. Saved credentials are no longer presented as proof that the service is reachable.
  • Preserve project selection and custom ordering when statuses refresh; append new projects at the end. Ordering is local to the current browser and is not synchronized across devices.
  • Add CI checks and a six-platform release-build workflow with SHA-256 and executable-architecture verification.

Upgrade and compatibility notes

Breaking change — PolicyBox: MCPBox no longer supplies PolicyBox identity, role, scope or context rules and manifests. These rules are not automatically converted into project bearer authorization.

  • Legacy identity-verification projects remain blocked until an administrator explicitly migrates them. Migration rotates the bearer credential, enables bearer authentication and pauses the project for access review.
  • Existing OAuth clients survive migration and must be reviewed before resuming a project. Retired PolicyBox runtime routes return 410 Gone.
  • Existing bearer/OAuth authentication, project pause, MCP session isolation and server/tool permissions remain in place. AgentBox direct bootstrap continues to use project authentication.
  • Inactive PolicyBox configuration, tables and external service data are preserved.

Migration and rollback (EN) · Миграция и откат (RU)

Both listeners default to the local machine: administration on 127.0.0.1:38181, project MCP on 127.0.0.1:38182. Earlier v1.3.0 binaries exposed MCP on 0.0.0.0; set MCPBOX_MCP_HOST explicitly when remote access is intended, with HTTPS and authentication configured. RagBox remains an optional external service; local Bleve search does not require it.

Stop MCPBox and back up its database, any external operational database, and runtime files before replacing the executable. Back up the database and skill_store/ together to retain packages, profiles, bindings and job files. Existing SkillBox data is not automatically migrated or deleted.

Known limitation

Local knowledge-base file upload/reindex operations can fail with missing bearer token when the internal admin request does not use the active listener/authentication configuration, including custom admin-port setups. This release does not claim to fix that server-side issue. Skill instruction discovery was verified with ChatGPT; end-to-end execution of third-party Skill scripts was not part of that verification.

Downloads

Choose the standalone executable for your OS and CPU architecture. amd64 is Intel/AMD x86-64; arm64 includes Apple Silicon and ARM64 systems. SHA256SUMS covers all six executables. No database, local configuration or user files are included.

MCPBox remains fully open source under Apache-2.0. No separate paid edition is required for Skills.

Full changelog: v1.3.0...v1.4.0


Русский — что нового и как обновиться

Основные изменения

  • Библиотека Skills: каталог с поиском и категориями, импорт GitHub/ZIP, подключение конкретных версий к проектам, чтение инструкций и ресурсов через MCP.
  • Задания для работы с файлами и запуска разрешённых Python, Node.js и Bash-скриптов в заранее подготовленных Docker-окружениях. Docker нужен только для выполнения скриптов; импорт и чтение инструкций работают без него.
  • Инструменты Skills появляются только у проектов с подключёнными навыками. Исправлена схема list_skills, мешавшая строгим клиентам обнаруживать инструменты после OAuth.
  • Навык нельзя отключить, пока у проекта остались его задания, включая ещё не запущенные.
  • Светлая, тёмная и системная темы с сохранением выбора.
  • Компактная «База знаний»: справка и сведения коллекции через !, запрос и результаты поиска в одном окне.
  • Новая навигация настроек, свёрнутая диагностика, понятная ошибка подключения RagBox с повтором и техническими подробностями.
  • Проекты в левой колонке перемещаются за ручку, кнопками ↑/↓ и клавиатурой. Порядок сохраняется для пользователя в текущем браузере; между устройствами он не синхронизируется.
  • CI и сборка шести платформ с проверкой архитектур и SHA-256.

Важно перед обновлением

Интеграция PolicyBox удалена. Старые проекты с проверкой идентификации требуют явной миграции администратором. Она заменяет bearer credential, включает bearer-аутентификацию и ставит проект на паузу. Проверьте доступ и существующие OAuth-подключения перед снятием паузы. Старые правила PolicyBox автоматически не преобразуются в bearer-доступ. Данные и неактивные настройки PolicyBox сохраняются.

MCP теперь по умолчанию слушает 127.0.0.1:38182, админка — 127.0.0.1:38181. Для удалённого доступа задайте адрес явно и настройте HTTPS и аутентификацию. Для локального Bleve RagBox не требуется.

Перед заменой файла остановите MCPBox и сделайте резервную копию базы и runtime-данных. Базу и skill_store/ сохраняйте вместе. Сторонние пакеты навыков сохраняют собственные лицензии; наличие в каталоге не гарантирует безопасность.

Известное ограничение: серверные операции загрузки/переиндексации базы знаний могут завершаться missing bearer token, в том числе при нестандартном порту админки. Это серверное исправление в релиз не входит. Через ChatGPT проверено обнаружение и чтение Skills; выполнение сторонних скриптов не заявляется как проверенное.

Скачайте файл для своей ОС и архитектуры; контрольные суммы находятся в SHA256SUMS. MCPBox остаётся полностью открытым по Apache-2.0.