MC

mladensu/cli-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

177 stars 38 forks Качество 68 Тренд 17MIT

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) для выполнения управляемых командных операций с помощью Комплексные функции безопасности.


Содержание

  1. Обзор
  2. Особенности
  3. Конфигурация
  4. Доступные инструменты
  • run_command
  • show_security_rules
  1. Использование с Claude Desktop
  • Конфигурация разработки/неопубликованных серверов
  • Конфигурация опубликованных серверов
  1. Особенности безопасности
  2. Обработка ошибок
  3. Развитие
  • Предварительные требования
  • Строительство и издательство
  • Отладка
  1. Лицензия

Обзор

Этот 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

  1. Overview
  2. Features
  3. Configuration
  4. Available Tools
  5. Usage with Claude Desktop
  6. Security Features
  7. Error Handling
  8. Development
  9. 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
Открыть полный README на GitHub

Установка

uvx cli-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "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" } } } }