Servidor MCP de Sigma

Un servidor MCP que expone la funcionalidad de pySigma a asistentes de IA y otros clientes MCP.

Características

Related MCP server: mcp-audit-server

Requisitos

• Python ≥ 3.10

• Poetry (para desarrollo / instalación)

Instalación

git clone <repo-url>
cd sigma-mcp-server
poetry install

Uso

Ejecución del servidor

poetry run sigma-mcp-server
# or, after installation:
sigma-mcp-server

El servidor escucha en stdio por defecto (transporte MCP estándar).

Configuración en VS Code / Claude Desktop

Añada la siguiente entrada a la configuración de su cliente MCP (por ejemplo, ~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sigma": {
      "command": "sigma-mcp-server"
    }
  }
}

Ajuste la ruta del command al binario instalado si no se encuentra en el PATH.

Referencia de herramientas

validate_rule

Valida una única regla Sigma.

Argumentos

Retorno

Una matriz JSON de objetos de problemas de validación. Cada objeto contiene:

Pueden estar presentes campos adicionales específicos de la subclase (ej. identifier).

Una matriz vacía significa que la regla superó todos los validadores activos.

configure_validators

Persiste una configuración de validador personalizada para la sesión MCP actual. Todas las llamadas posteriores a validate_rule dentro de la misma sesión utilizarán esta configuración.

Argumentos

Retorno

En caso de éxito: {"validator_names": ..., "exclusions": [...]} confirmando la configuración almacenada. En caso de error: {"error": "<description>"} cuando se suministra un identificador desconocido.

Ejemplo – excluir un único validador:

{"exclusions": ["identifier_existence"]}

Ejemplo – usar solo dos validadores:

{"validator_names": ["identifier_existence", "identifier_uniqueness"]}

Referencia de recursos

sigma://validators

Devuelve un objeto JSON que mapea cadenas de identificadores de validadores a sus descripciones legibles por humanos. Los identificadores de validadores se utilizan con configure_validators.

Ejemplo de respuesta (truncada):

{
  "identifier_existence": "Checks if rule has identifier.",
  "identifier_uniqueness": "Check rule UUID uniqueness.",
  ...
}

sigma://modifiers

Devuelve una matriz JSON ordenada de nombres de modificadores de valores Sigma que pueden utilizarse en condiciones de detección (ej. contains, startswith, re, base64).

Desarrollo

# Install dev dependencies
poetry install

# Run tests
poetry run pytest

# Run tests with coverage report
poetry run pytest --cov=sigma/mcp --cov-report=term-missing

# Type checking
poetry run mypy sigma/mcp/ tests/

# Code formatting
poetry run black sigma/ tests/ conftest.py

La cobertura de pruebas debe permanecer ≥ 95 %. Todo el código debe pasar mypy --strict y estar formateado con black en su configuración por defecto.

Licencia

MIT