🖥️ Servidor Shell MCP

👁 Versión de PyPI
👁 Licencia: MIT
👁 Pitón
👁 Estilo de código: negro

🚀 ¡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

Related MCP server: Terminal MCP Server

🚀 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:

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

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• execute_commandB