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

Этот MCP-сервер даёт LLM-агентам возможность выполнять команды в терминале, но с контролем безопасности. Он проверяет, что каждая команда и флаги входят в белый список, а пути не выходят за пределы разрешённой директории. В итоге нейросеть получает доступ к командной строке, но система остаётся защищённой от случайных или опасных действий.

Каталог MCP
MladenSU/cli-mcp-server

MladenSU/cli-mcp-server

от mladensu

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

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

README

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

Версии

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

CLI MCP Server

A secure Model Context Protocol (MCP) server implementation for executing controlled command-line operations with comprehensive security features.

Overview
Features
Configuration
Available Tools
- run_command
- show_security_rules
Usage with Claude Desktop
- Development/Unpublished Servers Configuration
- Published Servers Configuration
Security Features
Error Handling
Development
License

Overview

This MCP server enables secure command-line execution with robust security measures including command whitelisting, path validation, and execution controls. Perfect for providing controlled CLI access to LLM applications while maintaining security.

Features

🔒 Secure command execution with strict validation
⚙️ Configurable command and flag whitelisting with 'all' option
🛡️ Path traversal prevention and validation
🚫 Shell operator injection protection
⏱️ Execution timeouts and length limits
📝 Detailed error reporting
🔄 Async operation support
🎯 Working directory restriction and validation

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

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

`0.2.5`основная	05.07.2025
`0.2.4`	22.04.2025
`0.2.3`	21.04.2025
`0.2.2`	20.04.2025

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

Любой клиент

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

{
  "mcpServers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"mladensu-cli-mcp-server-5kzab0te32\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"cli-mcp-server\"],\"env\":{\"ALLOWED_DIR\":\"</your/desired/dir>\",\"ALLOWED_COMMANDS\":\"ls,cat,pwd,echo\",\"ALLOWED_FLAGS\":\"-l,-a,--help,--version\",\"MAX_COMMAND_LENGTH\":\"1024\",\"COMMAND_TIMEOUT\":\"30\",\"ALLOW_SHELL_OPERATORS\":\"false\"}}"

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": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

Claude Code

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

claude mcp add mladensu-cli-mcp-server-5kzab0te32 --env ALLOWED_DIR=</your/desired/dir> --env ALLOWED_COMMANDS=ls,cat,pwd,echo --env ALLOWED_FLAGS=-l,-a,--help,--version --env MAX_COMMAND_LENGTH=1024 --env COMMAND_TIMEOUT=30 --env ALLOW_SHELL_OPERATORS=false -- uvx cli-mcp-server

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

claude mcp add-json mladensu-cli-mcp-server-5kzab0te32 "{\"command\":\"uvx\",\"args\":[\"cli-mcp-server\"],\"env\":{\"ALLOWED_DIR\":\"</your/desired/dir>\",\"ALLOWED_COMMANDS\":\"ls,cat,pwd,echo\",\"ALLOWED_FLAGS\":\"-l,-a,--help,--version\",\"MAX_COMMAND_LENGTH\":\"1024\",\"COMMAND_TIMEOUT\":\"30\",\"ALLOW_SHELL_OPERATORS\":\"false\"}}"

Codex

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

codex mcp add mladensu-cli-mcp-server-5kzab0te32 --env ALLOWED_DIR=</your/desired/dir> --env ALLOWED_COMMANDS=ls,cat,pwd,echo --env ALLOWED_FLAGS=-l,-a,--help,--version --env MAX_COMMAND_LENGTH=1024 --env COMMAND_TIMEOUT=30 --env ALLOW_SHELL_OPERATORS=false -- uvx cli-mcp-server

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

[mcp_servers.mladensu-cli-mcp-server-5kzab0te32]
command = "uvx"
args = ["cli-mcp-server"]

[mcp_servers.mladensu-cli-mcp-server-5kzab0te32.env]
ALLOWED_DIR = "</your/desired/dir>"
ALLOWED_COMMANDS = "ls,cat,pwd,echo"
ALLOWED_FLAGS = "-l,-a,--help,--version"
MAX_COMMAND_LENGTH = "1024"
COMMAND_TIMEOUT = "30"
ALLOW_SHELL_OPERATORS = "false"

Perplexity

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

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

uvx cli-mcp-server

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

Windsurf

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

{
  "mcpServers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: mladensu-cli-mcp-server-5kzab0te32
    command: uvx
    args:
      - "cli-mcp-server"
    env:
      ALLOWED_DIR: </your/desired/dir>
      ALLOWED_COMMANDS: ls,cat,pwd,echo
      ALLOWED_FLAGS: -l,-a,--help,--version
      MAX_COMMAND_LENGTH: 1024
      COMMAND_TIMEOUT: 30
      ALLOW_SHELL_OPERATORS: false

Zed

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

{
  "context_servers": {
    "mladensu-cli-mcp-server-5kzab0te32": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "</your/desired/dir>",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

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

{
  "command": "uvx",
  "args": [
    "cli-mcp-server"
  ],
  "env": {
    "ALLOWED_DIR": "</your/desired/dir>",
    "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
    "ALLOWED_FLAGS": "-l,-a,--help,--version",
    "MAX_COMMAND_LENGTH": "1024",
    "COMMAND_TIMEOUT": "30",
    "ALLOW_SHELL_OPERATORS": "false"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx