Skip to main content
Glama
enesjakozh

mcp-shell-server

by tumf
GitHub
Python
MIT License
131
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor de shell MCP

código decodificador insignia de herrería

Un servidor de ejecución de comandos de shell seguro que implementa el Protocolo de Contexto de Modelo (MCP). Este servidor permite la ejecución remota de comandos de shell autorizados, compatibles con la entrada estándar.

Características

  • Ejecución segura de comandos : solo se pueden ejecutar los comandos incluidos en la lista blanca

  • Soporte de entrada estándar : pasa la entrada a los comandos a través de la entrada estándar

  • Salida completa : devuelve stdout, stderr, estado de salida y tiempo de ejecución

  • Seguridad del operador de shell : valida los comandos después de los operadores de shell (;, &&, ||, |)

  • Control de tiempo de espera : establece el tiempo máximo de ejecución de los comandos

Configuración del cliente MCP en su Claude.app

Versión publicada

code ~/Library/Application\ Support/Claude/claude_desktop_config.json
{ "mcpServers": { "shell": { "command": "uvx", "args": [ "mcp-shell-server" ], "env": { "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find" } }, } }

Versión local

Configuración

code ~/Library/Application\ Support/Claude/claude_desktop_config.json
{ "mcpServers": { "shell": { "command": "uv", "args": [ "--directory", ".", "run", "mcp-shell-server" ], "env": { "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find" } }, } }

Instalación

Instalación mediante herrería

Para instalar Shell Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install mcp-shell-server --client claude

Instalación manual

pip install mcp-shell-server

Instalación mediante herrería

Para instalar Shell Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install mcp-shell-server --client claude

Uso

Iniciando el servidor

ALLOW_COMMANDS="ls,cat,echo" uvx mcp-shell-server # Or using the alias ALLOWED_COMMANDS="ls,cat,echo" uvx mcp-shell-server

La variable de entorno ALLOW_COMMANDS (o su alias ALLOWED_COMMANDS ) especifica qué comandos se pueden ejecutar. Los comandos se pueden separar por comas con espacios opcionales.

Formatos válidos para ALLOW_COMMANDS o ALLOWED_COMMANDS:

ALLOW_COMMANDS="ls,cat,echo" # Basic format ALLOWED_COMMANDS="ls ,echo, cat" # With spaces (using alias) ALLOW_COMMANDS="ls, cat , echo" # Multiple spaces

Formato de solicitud

# Basic command execution { "command": ["ls", "-l", "/tmp"] } # Command with stdin input { "command": ["cat"], "stdin": "Hello, World!" } # Command with timeout { "command": ["long-running-process"], "timeout": 30 # Maximum execution time in seconds } # Command with working directory and timeout { "command": ["grep", "-r", "pattern"], "directory": "/path/to/search", "timeout": 60 }

Formato de respuesta

Respuesta exitosa:

{ "stdout": "command output", "stderr": "", "status": 0, "execution_time": 0.123 }

Respuesta de error:

{ "error": "Command not allowed: rm", "status": 1, "stdout": "", "stderr": "Command not allowed: rm", "execution_time": 0 }

Seguridad

El servidor implementa varias medidas de seguridad:

  1. Lista blanca de comandos : solo se pueden ejecutar comandos explícitamente permitidos

  2. Validación del operador de shell : los comandos después de los operadores de shell (;, &&, ||, |) también se validan con la lista blanca

  3. Sin inyección de shell : los comandos se ejecutan directamente sin interpretación de shell

Desarrollo

Configuración del entorno de desarrollo

  1. Clonar el repositorio

git clone https://github.com/yourusername/mcp-shell-server.git cd mcp-shell-server

  1. Instalar dependencias, incluidos los requisitos de prueba

pip install -e ".[test]"

Ejecución de pruebas

pytest

Referencia de API

Argumentos de solicitud

Campo

Tipo

Requerido

Descripción

dominio

cadena[]

Sí

Comando y sus argumentos como elementos de matriz

entrada estándar

cadena

No

Entrada que se pasará al comando

directorio

cadena

No

Directorio de trabajo para la ejecución de comandos

se acabó el tiempo

entero

No

Tiempo máximo de ejecución en segundos

Campos de respuesta

Campo

Tipo

Descripción

salida estándar

cadena

Salida estándar del comando

error de error estándar

cadena

Salida de error estándar del comando

estado

entero

Código de estado de salida

tiempo de ejecución

flotar

Tiempo de ejecución (en segundos)

error

cadena

Mensaje de error (solo aparece si falla)

Requisitos

  • Python 3.11 o superior

  • mcp>=1.1.0

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de ejecución de comandos de shell seguro que implementa el Protocolo de Contexto de Modelo (MCP). Este servidor permite la ejecución remota de comandos de shell autorizados, compatibles con la entrada estándar.

  1. Características
    1. Configuración del cliente MCP en su Claude.app
      1. Versión publicada
      2. Versión local
      3. Instalación mediante herrería
      4. Instalación manual
      5. Instalación mediante herrería
    2. Uso
      1. Iniciando el servidor
      2. Formato de solicitud
      3. Formato de respuesta
    3. Seguridad
      1. Desarrollo
        1. Configuración del entorno de desarrollo
        2. Ejecución de pruebas
      2. Referencia de API
        1. Argumentos de solicitud
        2. Campos de respuesta
      3. Requisitos
        1. Licencia

          Related Resources

          Related MCP Servers

          • Windows CLI MCP Server

            simon-ami
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
            Last updated -
            9
            256
            248
            MIT License

          • MCP Terminal Server

            RinardNick
            A
            security
            A
            license
            A
            quality
            A secure terminal execution server that enables controlled command execution with security features and resource limits via the Model Context Protocol (MCP).
            Last updated -
            1
            30
            7
            MIT License
            • Apple

          • Super Shell MCP Server

            cfdude
            A
            security
            A
            license
            A
            quality
            An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
            Last updated -
            9
            175
            7
            MIT License
            • Linux
            • Apple

          • MCP Shell Server

            diegofornalha
            A
            security
            F
            license
            A
            quality
            A secure server that implements the Model Context Protocol (MCP) to enable controlled execution of authorized shell commands with stdin support.
            Last updated -
            1

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/tumf/mcp-shell-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server