tumf/mcp-shell-server

tumf/mcp-shell-server

от tumf
MCP сервер для безопасного удалённого выполнения команд оболочки с белым списком, изоляцией окружения и аудитом. Поддерживает stdin, пайпы и лимиты времени/вывода. Идеален для интеграции shell-команд в MCP с контролем безопасности.

MCP Shell Server

codecov smithery badge

MseeP.ai Security Assessment Badge

A trusted execution server implementing the Model Context Protocol (MCP). It runs allowlisted commands as argv arrays, with stdin input, contained redirection, a minimal child environment, execution limits, and structured audit logging.

This package is not a sandbox. Allowing a command delegates that program the server process's existing OS authority. Read Trusted execution contract before configuring it.

mcp-shell-server MCP server

Features

  • Argv-based Command Execution: Allowed commands run via subprocess argv without shell-string interpretation
  • Standard Input Support: Pass input to commands via stdin
  • Comprehensive Output: Returns stdout, stderr, exit status, and execution time
  • Safe Pipeline Support: Pipelines preserve and validate argv segments instead of invoking a shell
  • Execution Limits: Server-side default timeout, maximum timeout, and output byte caps are enforced
  • Contained Redirection: <, >, and >> targets must stay inside the requested working directory
  • Minimal Child Environment: Child processes receive a small allowlisted environment instead of inheriting all server secrets
  • Structured Audit Logging: Success, rejection, timeout, output-cap, and process-error outcomes are logged with redaction

Часто задаваемые вопросы

Инструменты были проиндексированы:
shell_execute

Выполняет разрешённую команду как массив argv на хосте MCP-сервера. Все разрешённые команды запускаются с правами ОС процесса сервера; allowlist управляет именами исполняемых файлов, а не тем, что делает разрешённая программа. Разрешённые команды: wc, ls, pwd, cat, grep, find, touch Разрешённые шаблоны: Таймаут по умолчанию: 30s; максимальный таймаут: 300s; лимит вывода: 1048576 bytes

Параметры
  • commandstring[]обязательный

    Команда и её аргументы в виде массива

  • directorystring

    Необязательная рабочая директория. Если не указана, используется текущая рабочая директория процесса MCP-сервера; относительные пути разрешаются относительно той же CWD процесса сервера.

  • stdinstring

    Входные данные, которые будут переданы команде через стандартный ввод (stdin).

  • timeoutinteger

    Максимальное время выполнения в секундах; ограничено максимумом сервера.

1.1.14основная
1.1.13
1.1.12
1.1.11
1.1.10
1.1.9
1.1.8
1.1.7
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.4
1.0.4b1
1.0.3
1.0.2
1.0.1
1.0.0
0.1.0

Выберите клиент, чтобы установить tumf/mcp-shell-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"tumf-mcp-shell-server-5vbgk94aht\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-shell-server\"],\"env\":{\"ALLOW_COMMANDS\":\"ls,cat,pwd,grep,wc,touch,find\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add tumf-mcp-shell-server-5vbgk94aht --env ALLOW_COMMANDS=ls,cat,pwd,grep,wc,touch,find -- uvx mcp-shell-server

Либо через JSON-конфиг:

claude mcp add-json tumf-mcp-shell-server-5vbgk94aht "{\"command\":\"uvx\",\"args\":[\"mcp-shell-server\"],\"env\":{\"ALLOW_COMMANDS\":\"ls,cat,pwd,grep,wc,touch,find\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add tumf-mcp-shell-server-5vbgk94aht --env ALLOW_COMMANDS=ls,cat,pwd,grep,wc,touch,find -- uvx mcp-shell-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.tumf-mcp-shell-server-5vbgk94aht]
command = "uvx"
args = ["mcp-shell-server"]

[mcp_servers.tumf-mcp-shell-server-5vbgk94aht.env]
ALLOW_COMMANDS = "ls,cat,pwd,grep,wc,touch,find"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите tumf/mcp-shell-server, а в поле команды запуска — строку ниже:
uvx mcp-shell-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например tumf-mcp-shell-server-5vbgk94aht.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: tumf-mcp-shell-server-5vbgk94aht
    command: uvx
    args:
      - "mcp-shell-server"
    env:
      ALLOW_COMMANDS: ls,cat,pwd,grep,wc,touch,find
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "tumf-mcp-shell-server-5vbgk94aht": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}

Похожие MCP-сервера

g0t4/mcp-server-commands

g0t4/mcp-server-commands

от g0t4

Выполняет команды и скрипты на компьютере: bash, python, zsh, создаёт файлы, передаёт код через stdin и возвращает вывод. Работает с локальными моделями.

TypeScript⭐ 235
sonirico/mcp-shell

sonirico/mcp-shell

от sonirico

MCP сервер для безопасного выполнения shell-команд через LLM с полным контролем. Secure-режим по умолчанию ограничивает утилиты белым списком read-only команд. Политики настраиваются через YAML. Идеален для Claude Desktop и агентов, где важна безопасность.

Go⭐ 108
MladenSU/cli-mcp-server

MladenSU/cli-mcp-server

от mladensu

MCP сервер для безопасного выполнения команд CLI с whitelist-фильтрацией. Защищает от path traversal, ограничивает команды, флаги и длину, устанавливает таймауты. Идеален для LLM-приложений с контролируемым доступом к терминалу.

Python⭐ 177
alfonsograziano/node-code-sandbox-mcp

alfonsograziano/node-code-sandbox-mcp

от alfonsograziano

Выполняет Node.js-код в изолированном Docker-контейнере: ставит npm-пакеты, запускает shell-команды и возвращает вывод.

TypeScript⭐ 158
tufantunc/ssh-mcp

tufantunc/ssh-mcp

от tufantunc

MCP-совместимый сервер для удаленного выполнения shell-команд на Linux и Windows через SSH. Поддерживает sudo, настраиваемые таймауты и аутентификацию. Отлично подходит DevOps и разработчикам, работающим с LLM.

TypeScript⭐ 816
ferrislucas/iterm-mcp

ferrislucas/iterm-mcp

от ferrislucas

Разработчики: MCP сервер для iTerm дает модели полный контроль над терминалом - выполнение команд, чтение вывода, управление REPL. Эффективный расход токенов, простая интеграция. Делегируйте задачи и наблюдайте за работой.

TypeScript⭐ 570
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин