🖥️ 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"
)
# 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