# AiSecBox CLI

AiSecBox CLI es una herramienta de línea de comandos diseñada para configurar y gestionar la seguridad del **Model Context Protocol (MCP)** en proyectos de desarrollo. Facilita la integración de medidas de seguridad con agentes de IA como Gemini, Claude, Cursor y otros.

## Propósito

- Validar el entorno de desarrollo (repositorio Git, estado de trabajo limpio).
- Detectar automáticamente agentes de IA configurados en el proyecto.
- Generar configuraciones MCP seguras para dichos agentes.
- Ofrecer un proceso interactivo para añadir o configurar agentes adicionales.
- Crear directorios necesarios y archivos de configuración estructurados.

## Comandos

### `init`

Configura el servidor MCP de seguridad en tu proyecto. Pasos que realiza:

1. Muestra banner y requisitos del sistema.
2. Verifica que estés dentro de un repositorio Git y que no haya cambios sin confirmar.
3. Solicita la API key de AiSecBox (sin guardarse de forma insegura).
4. Detecta los agentes de IA presentes en el directorio raíz (Gemini, Claude, Cursor, Generic).
5. Si no se detectan agentes, ofrece crear una configuración genérica (`.mcp.json`).
6. Pregunta si deseas configurar agentes adicionales (hasta un máximo de 4). Para ello presenta un menú interactivo con flechas arriba/abajo donde puedes seleccionar el tipo de agente.
7. Por cada agente seleccionado:
   - Crea el directorio correspondiente si no existe (ej. `.gemini/`).
   - Genera el archivo de configuración con los parámetros de conexión al servidor MCP.
8. Muestra un resumen final con instrucciones para verificar la conexión en cada agente.

**Nota:** Durante el proceso, se te consultará antes de cada paso relevante. Puedes cancelar en cualquier momento.

### `version`

Muestra el número de versión de la CLI.

```bash
aisecbox-cli version
```

## Flujo de trabajo típico

```bash
# Desde la raíz de tu proyecto Git
aisecbox-cli init
```

El comando `init` guiará a través de los pasos necesarios para dejar tu entorno listo para usar MCP de forma segura.

## Requisitos del sistema

- Git instalado y disponible en el PATH.
- Ejecutar desde la raíz del repositorio Git del proyecto.
- Conexión a internet para obtener la API key (si no la tienes, se te indicará cómo generarla).

## Seguridad

- La API key se solicita por consola y no se almacena en el repositorio.
- Se crea o actualiza la configuración MCP preservando otros campos existentes.
- Se validan los cambios pendientes en Git para evitar configuraciones inconsistentes.

---

Este CLI forma parte del ecosistema AiSecBox para pruebas de seguridad en Model Context Protocol.
