Servidor de comandos MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) seguro para ejecutar comandos del sistema a través de aplicaciones LLM como Claude.

Inicio rápido

1. Instalar el paquete:

uv pip install mcp-command-server

2. Configurar comandos permitidos:

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Agregar a la configuración de Claude Desktop:

{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

Related MCP server: Shell-MCP

Características

• Ejecución segura de comandos con lista blanca

• ✅ Confirmación del usuario para todos los comandos

• 📝 Registro de auditoría completo

• 🔍 Validación y saneamiento de entradas

• 🤖 Integración de Claude Desktop

Documentación

Para obtener la documentación completa, consulte el directorio docs/ :

• Guía de instalación

• Pautas de seguridad

• Referencia de API

• Ejemplos de uso

• Solución de problemas

Desarrollo

Configuración

# Clone repository
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# Create virtual environment
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

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

Pruebas

# Run all tests
pytest

# Run specific test file
pytest tests/unit/security/test_validator.py

# Run with coverage
pytest --cov=mcp_command_server

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Ejecutar pruebas y linting

4. Enviar una solicitud de extracción

Licencia

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