Для чего этот сервер?

Этот сервер даёт языковой модели безопасный доступ к shell-командам. Вместо того чтобы разрешать всё подряд, он ограничивает выполнение заранее одобренным набором утилит вроде ls, cat или grep. Можно расширить политику через конфиг или вовсе отключить защиту, но по умолчанию сервер никуда не пускает LLM без надзора. Удобно, когда нужно автоматизировать работу с файловой системой, логированием или сбором данных, не рискуя всей системой.

Каталог MCP
sonirico/mcp-shell

sonirico/mcp-shell

от sonirico

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

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

mcp-shell

MCP server that runs shell commands. Your LLM gets a tool; you get control over what runs and how.

Built on mark3labs/mcp-go. Written in Go.

Run it

Docker (easiest):

docker run -it --rm -v /tmp/mcp-workspace:/tmp/mcp-workspace sonirico/mcp-shell:latest

From source:

git clone https://github.com/sonirico/mcp-shell && cd mcp-shell
make install
mcp-shell

Configure it

Secure mode is the default. With no config file, mcp-shell boots in secure mode and registers only typed tools: file reads, grep/glob, git inspection, and (opt-in) file/git writes and operator-defined scripts. There is no raw shell command. You only need a config file to change the defaults below. To run fully unrestricted you must opt in explicitly:

MCP_SHELL_ALLOW_UNSAFE=1 mcp-shell   # disables secure mode; the only tool is shell_exec

To customize the policy, point to a YAML config:

export MCP_SHELL_SEC_CONFIG_FILE=/path/to/security.yaml
mcp-shell

Secure mode (default) — typed tools only, every path confined to working_directory:

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

У этого сервера пока нет списка инструментов.

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

Любой клиент

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

{
  "mcpServers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

VS Code

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

{
  "servers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "type": "stdio",
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

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

code --add-mcp "{\"name\":\"sonirico-mcp-shell-qy3c7l2lbu\",\"type\":\"stdio\",\"env\":{\"MCP_SHELL_LOG_LEVEL\":\"info\"},\"args\":[\"run\",\"--rm\",\"-i\",\"sonirico/mcp-shell:latest\"],\"command\":\"docker\"}"

Claude 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": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

Claude Code

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

claude mcp add sonirico-mcp-shell-qy3c7l2lbu --env MCP_SHELL_LOG_LEVEL=info -- docker run --rm -i sonirico/mcp-shell:latest

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

claude mcp add-json sonirico-mcp-shell-qy3c7l2lbu "{\"env\":{\"MCP_SHELL_LOG_LEVEL\":\"info\"},\"args\":[\"run\",\"--rm\",\"-i\",\"sonirico/mcp-shell:latest\"],\"command\":\"docker\"}"

Codex

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

codex mcp add sonirico-mcp-shell-qy3c7l2lbu --env MCP_SHELL_LOG_LEVEL=info -- docker run --rm -i sonirico/mcp-shell:latest

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

[mcp_servers.sonirico-mcp-shell-qy3c7l2lbu]
command = "docker"
args = ["run", "--rm", "-i", "sonirico/mcp-shell:latest"]

[mcp_servers.sonirico-mcp-shell-qy3c7l2lbu.env]
MCP_SHELL_LOG_LEVEL = "info"

Perplexity

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

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

docker run --rm -i sonirico/mcp-shell:latest

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

Windsurf

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

{
  "mcpServers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

Cline

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

{
  "mcpServers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: sonirico-mcp-shell-qy3c7l2lbu
    command: docker
    args:
      - "run"
      - "--rm"
      - "-i"
      - "sonirico/mcp-shell:latest"
    env:
      MCP_SHELL_LOG_LEVEL: info

Zed

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

{
  "context_servers": {
    "sonirico-mcp-shell-qy3c7l2lbu": {
      "env": {
        "MCP_SHELL_LOG_LEVEL": "info"
      },
      "args": [
        "run",
        "--rm",
        "-i",
        "sonirico/mcp-shell:latest"
      ],
      "command": "docker"
    }
  }
}

Конфиг для установки сервера

{
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "sonirico/mcp-shell:latest"
  ],
  "env": {
    "MCP_SHELL_LOG_LEVEL": "info"
  }
}

Информация о сервере

Номер в рейтинге: #177
Звезд на Github: 108
Форков на Github: 21
Язык реализации: Go
Лицензия: GPL-3.0
Официальный сервер: Нет
Дата обновления данных: 20.10 в 06:23
Идентификатор: -xhGUH-_kW5l-zGP
Категории: Автоматизация ОС, Командная строка

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

tumf/mcp-shell-server

от tumf

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

ferrislucas/iterm-mcp

от ferrislucas

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

tufantunc/ssh-mcp

от tufantunc

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

eirikb/any-cli-mcp-server

от eirikb

Превращает любую CLI-утилиту в MCP сервер. Анализируя вывод --help, автоматически создает MCP инструменты. Полезен разработчикам, автоматизирующим работу с консольными командами.

misiektoja/kill-process-mcp

от misiektoja

Кроссплатформенный MCP-сервер для управления процессами через LLM. Выводит список процессов с сортировкой по CPU/RAM и убивает выбранные по текстовой команде. Полезен для быстрого прибивания жадных...

promptexecution/just-mcp

от promptexecution

MCP сервер для интеграции Just с AI-ассистентами: позволяет находить, выполнять и анализировать рецепты Justfile через MCP. Безопасная альтернатива bash, сохраняет контекст LLM и упрощает работу с командами. Идеально для автоматизации.