MCP Command Server

MCP Command Server

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

Inicio Rápido

1. Instale el paquete:

uv pip install mcp-command-server

2. Configure los comandos permitidos:

export ALLOWED_COMMANDS="ls,pwd,echo"

3. Agregue 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"
      }
    }
  }
}

Características

• 🔒 Ejecución segura de comandos con lista blanca
• ✅ Confirmación del usuario para todos los comandos
• 📝 Registro de auditoría integral
• 🔍 Validación y saneamiento de entradas
• 🤖 Integración con Claude Desktop

Documentación

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

• Guía de Instalación
• Directrices de Seguridad
• Referencia de la 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

Contribuciones

1. Haga un fork del repositorio
2. Cree su rama de características
3. Ejecute las pruebas y el linting
4. Envíe una solicitud de extracción

Licencia

Licencia MIT - consulte LICENSE para más detalles.