blackarch-AI

MCP-сервер и набор Claude Code Skills с контролем доступа для задач red-team и blue-team по безопасности на BlackArch Linux.

Что это такое

• MCP-сервер (src/blackarch_ai_mcp/) — оборачивает локальные инструменты безопасности (nmap, gobuster, nikto, hydra, а также локальные аудиты blue-team) как инструменты MCP, так что любой MCP-совместимый клиент может их вызывать.

• Claude Code Skills (.claude/skills/) — пошаговые руководства в Markdown, которые проводят через рабочие процессы red-team и blue-team с использованием этих инструментов.

Related MCP server: MoonMCP

Модель безопасности: контроль доступа

Ни один инструмент red-team не будет запущен против цели, которая не была явно авторизована. Каждый инструмент, который взаимодействует с сетевой целью (nmap_scan, gobuster_dir, nikto_scan, hydra_bruteforce), сначала проверяет scope.yaml и отказывается с четким сообщением, если цель не указана в списке с действительной, не истекшей авторизацией.

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

scope.yaml находится в .gitignore — он локальный и никогда не публикуется. Полный контракт см. в docs/SCOPE.md.

Инструменты blue-team (audit_listening_ports, audit_suid_world_writable, review_auth_log, lint_ssh_config, audit_pacman_packages, crack_hash_offline) являются только локальными и не имеют контроля доступа — они никогда не обращаются к третьим сторонам.

Этот проект не предоставляет разрешения на тестирование чего-либо. Вы несете ответственность за наличие явного письменного разрешения, прежде чем направлять какой-либо инструмент red-team на цель. Несанкционированное сканирование/эксплуатация систем, которыми вы не владеете или на тестирование которых у вас нет письменного разрешения, является незаконным в большинстве юрисдикций.

Установка

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

Запуск MCP-сервера отдельно

uv run python -m blackarch_ai_mcp.server

Регистрация в Claude Code

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

Затем в сессии Claude Code вызовите Skill (например, "run a host audit" или /blue-team-host-audit, если включен вызов через слэш) или напрямую используйте инструмент mcp__blackarch-ai__*.

Структура

См. docs/ARCHITECTURE.md о том, как компоненты сочетаются, и docs/TOOLS.md для полной справки по инструментам.

Тесты

uv run pytest

Лицензия

MIT — см. LICENSE.