
mladensu/cli-mcp-server
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
mladensu/cli-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/mladensu/cli-mcp-server.
Обзор
mladensu/cli-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/mladensu/cli-mcp-server.
Обзор (машинный перевод)
Реализация сервера Secure Model Context Protocol (MCP) для выполнения управляемых командных операций с помощью Комплексные функции безопасности.
Содержание
- Обзор
- Особенности
- Конфигурация
- Доступные инструменты
- run_command
- show_security_rules
- Использование с Claude Desktop
- Конфигурация разработки/неопубликованных серверов
- Конфигурация опубликованных серверов
- Особенности безопасности
- Обработка ошибок
- Развитие
- Предварительные требования
- Строительство и издательство
- Отладка
- Лицензия
Обзор
Этот MCP-сервер обеспечивает безопасное выполнение командной строки с надёжными мерами безопасности, включая белый список команд, путь проверка и управление выполнением. Идеально подходит для обеспечения контролируемого доступа CLI к LLM-приложениям при сохранении безопасности.
Особенности
- 🔒 Безопасное выполнение команд с строгой валидацией
- ⚙️ Настраиваемое белый список команд и флагов с опцией «все»
- 🛡️ Предотвращение и валидация прохождения по путям
- 🚫 Защита от впрыска оператора оболочки
- ⏱️ Тайм-ауты выполнения и ограничения по длине
- 📝 Детальная отчетность об ошибках
- 🔄 Поддержка асинхронных операций
- 🎯 Ограничение и валидация рабочих каталогов
Конфигурация
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
CLI MCP Server
A secure Model Context Protocol (MCP) server implementation for executing controlled command-line operations with comprehensive security features.
Table of Contents
- Overview
- Features
- Configuration
- Available Tools
- Usage with Claude Desktop
- 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
Configuration
Configure the server using environment variables:
| Variable | Description | Default |
|---|---|---|
ALLOWED_DIR |
Base directory for command execution (Required) | None (Required) |
ALLOWED_COMMANDS |
Comma-separated list of allowed commands or ‘all’ | ls,cat,pwd |
ALLOWED_FLAGS |
Comma-separated list of allowed flags or ‘all’ | -l,-a,--help |
MAX_COMMAND_LENGTH |
Maximum command string length | 1024 |
COMMAND_TIMEOUT |
Command execution timeout (seconds) | 30 |
Установка
uvx cli-mcp-serverКонфигурация
{
"mcpServers": {
"cli-mcp-server": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/repo>/cli-mcp-server",
"run",
"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"
}
}
}
}