Skip to main content
Glama
Capsule Bash Server

Capsule Bash Server

Official
by capsulerun

MCP-сервер Capsule Bash

MCP Server

MCP-сервер, который дает вашему ИИ-агенту возможность выполнять bash-команды в безопасной, постоянной и изолированной среде.

Как это работает

Каждая сессия выполняется внутри песочницы WebAssembly. Песочница обеспечивает:

  • Постоянное состояние: текущая рабочая директория (cwd), переменные окружения и изменения в файловой системе сохраняются между командами в рамках одной сессии.

  • Diff файловой системы: каждый ответ run включает в себя diff изменений на диске.

  • Изолированная память: каждая сессия имеет свое собственное адресное пространство, утечка данных между сессиями исключена.

  • Отсутствие доступа к хосту: песочница не имеет доступа к файловой системе или сети вашего хоста.

Узнайте больше о Capsule Bash.

Related MCP server: execkit-mcp

Инструменты

Инструмент

Описание

run

Выполнение bash-команды в изолированной сессии. Возвращает stdout, stderr, код выхода, diff файловой системы и текущее состояние (cwd + env).

reset

Сброс файловой системы и состояния (cwd, переменные окружения) сессии до исходных значений.

sessions

Список всех активных сессий.

Сессии

Команды внутри одного session_id используют общие cwd, переменные окружения и состояние файловой системы между вызовами.

Пример

Попросите вашего ИИ-агента:

"Напиши скрипт на Python, который вычисляет среднее арифметическое списка чисел."

Агент последовательно вызывает run:

{ "command": "mkdir -p /data && cd /data", "session_id": "custom_session" }
{ "command": "echo 'nums = [x for x in [1, 2, 3, []] if isinstance(x, int)]\nprint(sum(nums) / len(nums))' > avg.py", "session_id": "custom_session" }
{ "command": "python3 avg.py", "session_id": "custom_session" }

Каждый вызов возвращает stdout, stderr, exitCode, diff файловой системы и обновленное state для обогащения контекста и отслеживания истории диалога.

Настройка

Добавьте в конфигурацию вашего MCP-клиента (например, Claude Desktop, Cursor):

{
  "mcpServers": {
    "bash": {
      "command": "npx",
      "args": ["-y", "@capsule-run/bash-mcp"]
    }
  }
}

Ограничения

  • Реализованы не все bash-команды и опции. Не стесняйтесь создать issue, если какая-то команда отсутствует или работает некорректно.

Available Tools

3 tools
resetA

Reset a session's filesystem and shell state (cwd, env vars) to their initial values. Useful to start fresh without creating a new session.

Inputs: session_id.

runB

Execute a Bash command in the sandboxed environment

Inputs: command (required), session_id.

sessionsA

List all active session IDs and their current state.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a unique, clear purpose: reset reverts state, run executes commands, and sessions lists active sessions. No ambiguity or overlap exists.

    Naming Consistency5/5

    All tool names are single, imperative verbs (reset, run, sessions) following a consistent, simple pattern.

    Tool Count5/5

    Three tools is well-scoped for a bash sandbox server, covering essential operations without superfluous or missing tools.

    Completeness4/5

    The set covers core actions (run, reset, list sessions) but lacks explicit session creation; likely sessions are created implicitly, leaving a minor gap.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers