blackarch-AI

범위 제한 MCP 서버 및 BlackArch Linux에서 레드팀 및 블루팀 보안 워크플로를 위한 Claude Code Skills 세트입니다.

이 프로젝트의 목적

• MCP 서버 (src/blackarch_ai_mcp/) — 로컬 보안 도구(nmap, gobuster, nikto, hydra, 로컬 블루팀 감사)를 MCP 도구로 래핑하여 모든 MCP 호환 클라이언트가 호출할 수 있도록 합니다.

• Claude Code Skills (.claude/skills/) — 해당 도구를 사용하여 레드팀 및 블루팀 워크플로를 안내하는 마크다운 플레이북입니다.

Related MCP server: MoonMCP

안전 모델: 범위 제한

명시적으로 승인되지 않은 대상에 대해 레드팀 도구가 실행되지 않습니다. 네트워크 대상을 다루는 모든 도구(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를 참조하세요.

블루팀 도구(audit_listening_ports, audit_suid_world_writable, review_auth_log, lint_ssh_config, audit_pacman_packages, crack_hash_offline)는 로컬 전용이며 제한되지 않습니다. 타사에 절대 접촉하지 않습니다.

이 프로젝트는 어떤 것도 테스트할 권한을 부여하지 않습니다. 레드팀 도구를 대상에 지정하기 전에 명시적인 서면 허가를 받을 책임은 사용자에게 있습니다. 소유하지 않았거나 테스트에 대한 서면 허가를 받지 않은 시스템에 대한 무단 스캔/악용은 대부분의 관할권에서 불법입니다.

설치

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 참조.