blackarch-AI

一个范围门控的MCP服务器及一组Claude Code Skills，用于BlackArch Linux上的红队和蓝队安全工作流。

这是什么

• MCP服务器（src/blackarch_ai_mcp/）——将本地安全工具（nmap、gobuster、nikto、hydra，以及本地蓝队审计）封装为MCP工具，使任何MCP兼容客户端均可调用。

• Claude Code Skills（.claude/skills/）——使用这些工具逐步完成红队和蓝队工作流的Markdown操作手册。

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被git忽略——它是本地的，永远不会发布。完整约定请参见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。