blackarch-AI

Un servidor MCP con control de alcance y un conjunto de habilidades de Claude Code para flujos de trabajo de seguridad de equipo rojo y equipo azul en BlackArch Linux.

Qué es esto

• Servidor MCP (src/blackarch_ai_mcp/) — envuelve herramientas de seguridad locales (nmap, gobuster, nikto, hydra, más auditorías locales de equipo azul) como herramientas MCP, para que cualquier cliente compatible con MCP pueda llamarlas.

• Habilidades de Claude Code (.claude/skills/) — manuales en markdown que guían a través de flujos de trabajo de equipo rojo y equipo azul utilizando esas herramientas.

Related MCP server: MoonMCP

Modelo de seguridad: control de alcance

Ninguna herramienta de equipo rojo se ejecutará contra un objetivo que no esté explícitamente autorizado. Cada herramienta que toca un objetivo de red (nmap_scan, gobuster_dir, nikto_scan, hydra_bruteforce) verifica scope.yaml primero y se niega con un mensaje claro si el objetivo no está listado con autorización válida y no vencida.

cp scope.example.yaml scope.yaml
# edit scope.yaml: add host/cidr, authorized_by, authorization_ref, expires

scope.yaml está en gitignore — es local, nunca se publica. Consulta docs/SCOPE.md para el contrato completo.

Las herramientas de equipo azul (audit_listening_ports, audit_suid_world_writable, review_auth_log, lint_ssh_config, audit_pacman_packages, crack_hash_offline) son solo locales y no están controladas — nunca tocan a un tercero.

Este proyecto no otorga autorización para probar nada. Eres responsable de tener permiso explícito y por escrito antes de apuntar cualquier herramienta de equipo rojo a un objetivo. El escaneo/explotación no autorizado de sistemas que no posees o para los que no tienes permiso por escrito es ilegal en la mayoría de las jurisdicciones.

Instalar

sudo pacman -S --needed python-uv
uv sync

Ejecutar el servidor MCP de forma independiente

uv run python -m blackarch_ai_mcp.server

Registrar con Claude Code

claude mcp add blackarch-ai -- uv --directory /path/to/blackarch-ai run python -m blackarch_ai_mcp.server

Luego, en una sesión de Claude Code, invoca una Habilidad (por ejemplo, "ejecutar una auditoría de host", o /blue-team-host-audit si la invocación con barra está habilitada) o llama directamente a una herramienta mcp__blackarch-ai__*.

Estructura

Consulta docs/ARCHITECTURE.md para ver cómo encajan las piezas y docs/TOOLS.md para la referencia completa de herramientas.

Pruebas

uv run pytest

Licencia

MIT — consulta LICENSE.