Servidor MCP de Shell

🖥️ Servidor Shell MCP

🚀 ¡Añade funciones de ejecución de comandos de shell seguro a tus aplicaciones de IA con el Servidor Shell MCP! Diseñado para el Protocolo de Contexto de Modelo.

✨ Características

🔒 Ejecución segura : los comandos se ejecutan solo en directorios específicos
🐚 Múltiples shells : compatibilidad con bash, sh, cmd y powershell
⏱️ Control de tiempo de espera : finalización automática de comandos de larga duración
🌍 Multiplataforma : funciona en sistemas Unix y Windows
🛡️ Seguro por defecto : validación de directorio y shell integrada

🚀 Inicio rápido

Instalación

# Using pip
pip install shell-mcp-server

# Using uv (recommended)
uv pip install shell-mcp-server

🔌 Integración de escritorio de Claude

Agregue esto a su configuración de Claude Desktop para habilitar la ejecución de comandos de shell:

{
    "mcpServers": {
        "shell-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/shell-mcp-server",
                "run",
                "shell-mcp-server",
                "/path/to/allowed/dir1",
                "/path/to/allowed/dir2",
                "--shell", "bash", "/bin/bash",
                "--shell", "zsh", "/bin/zsh"
            ]
        }
    }
}

Ejemplos de uso

Operaciones básicas con archivos

# List directory contents
result = execute_command(
    command="ls -la",
    shell="bash",
    cwd="/path/to/project"
)

# Find files by pattern
result = execute_command(
    command="find . -name '*.py'",
    shell="bash",
    cwd="/path/to/project"
)

Gestión de proyectos

# Git operations
result = execute_command(
    command="git status && git diff",
    shell="bash",
    cwd="/path/to/repo"
)

# Package management
result = execute_command(
    command="pip list --outdated",
    shell="bash",
    cwd="/path/to/python/project"
)

Información del sistema

# Resource usage
result = execute_command(
    command="df -h && free -h",
    shell="bash",
    cwd="/path/to/dir"
)

# Process monitoring
result = execute_command(
    command="ps aux | grep python",
    shell="bash",
    cwd="/path/to/dir"
)

Procesamiento de archivos

# Search file content
result = execute_command(
    command="grep -r 'TODO' .",
    shell="bash",
    cwd="/path/to/project"
)

# File manipulation
result = execute_command(
    command="awk '{print $1}' data.csv | sort | uniq -c",
    shell="bash",
    cwd="/path/to/data"
)

Ejemplos específicos de Windows

# List processes
result = execute_command(
    command="Get-Process | Where-Object {$_.CPU -gt 10}",
    shell="powershell",
    cwd="C:\\path\\to\\dir"
)

# System information
result = execute_command(
    command="systeminfo | findstr /B /C:'OS'",
    shell="cmd",
    cwd="C:\\path\\to\\dir"
)

⚙️ Configuración

Configurar el comportamiento con argumentos de la línea de comandos:

Argumento	Descripción
`directories`	📁 Lista de directorios permitidos
`--shell name path`	🐚 Especificaciones del shell (nombre y ruta)

Variables de entorno:

COMMAND_TIMEOUT : ⏱️ Tiempo máximo de ejecución en segundos (predeterminado: 30)

🛡️ Funciones de seguridad

🔐 Aislamiento de directorio : los comandos solo se pueden ejecutar en directorios específicos
🔒 Control de shell : solo se permiten shells configurados
⏰ Protección de tiempo de espera : todos los comandos tienen un tiempo de espera configurable
🛑 Validación de ruta : La validación del directorio de trabajo evita ataques transversales
👤 Aislamiento de permisos : los comandos se ejecutan con los mismos permisos que el proceso del servidor

🛠️ Desarrollo

Configure su entorno de desarrollo:

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install development dependencies
uv pip install -e ".[test]"

# Run tests
python -m pytest

# Run tests with coverage
python -m pytest --cov=shell_mcp_server

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Siéntase libre de:

🐛 Informar errores
💡 Sugerir características
🔧 Enviar solicitudes de extracción
📚 Mejorar la documentación

📜 Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles.

🌟 ¡Mejora tu IA con acceso seguro a Shell! 🌟

Creado para el Protocolo de Contexto del Modelo | Hecho con ❤️ por la Comunidad MCP

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor seguro que permite que las aplicaciones de IA ejecuten comandos de shell en directorios específicos, admitiendo múltiples tipos de shell (bash, sh, cmd, powershell) con funciones de seguridad integradas como aislamiento de directorio y control de tiempo de espera.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Terminal Server
dillip285
A
security
A
license
A
quality
A secure server for executing terminal commands within predefined paths, allowing safe interaction by Large Language Models with operating system environments.
Last updated -
1
57
8
JavaScript
MIT License
MCP Server Enhanced SSH
8bit-wraith
-
security
F
license
-
quality
A robust SSH server facilitating secure remote command execution with TMUX session management, multi-window support, and smart session recovery for improved AI-human interaction.
Last updated -
4
Python
MCP Terminal Server
cwmoore-ai
-
security
A
license
-
quality
A lightweight FastAPI server that allows remote execution of shell commands on Windows, with real-time output streaming and security features like API key authentication and rate limiting.
Last updated -
1
Python
MIT License
SSH MCP Server
format37
-
security
F
license
-
quality
Enables AI assistants to securely execute shell commands on local machines through an SSH interface with session management, command execution, and sudo support.
Last updated -
Python

View all related MCP servers

Shell MCP Server