whit3rabbit0/project_astro

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

46 stars 20 forks Качество 70 Тренд 20

Repository Install

MCP Server и Kali API Server с интеграцией Claude Desktop

Обзор

Уровень интеллекта для тестирования проникновения на основе LLM. Поставляется в качестве MCP-сервера с 38 обертками инструментов Kali, отслеживанием взаимодействия, обеспечением соблюдения объема и структурированным выводом для любого MCP-совместимого клиента. Используйте только против целей, которыми вы владеете или имеете явное разрешение на тестирование. V1 был прокси-сервером Flask, который переключал JSON между Claude Desktop и процессом kali api server.py. Он работал, но архитектура была хрупкой — два сервера, никакого состояния, никаких рельсов безопасности, 10 инструментов, жестко подключенных к конечным точкам HTTP. Recon: amass, subfinder, ffuf, whatweb, dnsrecon, aharvester, ядра Эксплуатация: searchsploit, crackmapexec, hashcat, responseer, smbclient, evil-winrm Комплект Impacket: secretdump, psexec, wmiexec, kerberoast, getnpusers, getst, ticketer Постэксплуатация: линпеас, винпеас, борзая, долота, неткат, мсфвеном Tunneling/C2: burp (прокси-интеграция), certipy (AD CS-атаки)

Обзор (машинный перевод)

Это девкит. Используйте только против целей, которыми вы владеете или имеете явное разрешение на тестирование.

Что изменилось в V1

V1 был прокси-сервером Flask, который переключал JSON между Claude Desktop и процессом T0. Он работал, но архитектура была хрупкой — два сервера, никакого состояния, никаких рельсов безопасности, 10 инструментов, жестко подключенных к конечным точкам HTTP.

V2 представляет собой переписывание:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Project Astro V2 - Disclaimer - This is DEVKIT

Intelligence layer for LLM-driven penetration testing. Ships as an MCP server with 38 Kali tool wrappers, engagement tracking, scope enforcement, and structured output for any MCP-compatible client.

This is a devkit. Use only against targets you own or have explicit authorization to test.

What changed from V1

V1 was a Flask proxy that shuttled JSON between Claude Desktop and a kali_api_server.py process. It worked, but the architecture was fragile — two servers, no state, no safety rails, 10 tools hard-wired to HTTP endpoints.

V2 is a ground-up rewrite:

	V1	V2
Architecture	Flask API + MCP shim (2 processes)	Single FastMCP server (`mcp` SDK)
Transport	HTTP only	Streamable-HTTP or stdio
Tools	10, inline in one file	38 wrappers (+ custom script executor), each in `src/astro/tools/`
Tool validation	None — raw strings to shell	Pydantic-based validation, shell metacharacter blocking, blocked-flag list
Scope enforcement	None	CIDR + domain allowlists via YAML config; every tool call is checked
Rate limiting	None	Per-tool async semaphores
Auth	None	API key + OIDC support
Engagement tracking	None	SQLite-backed finding recorder with per-engagement isolation
Output parsing	Raw stdout	Structured parsers for nmap, sqlmap, wpscan, nuclei, subfinder, etc.
Reporting	None	SARIF, HTML, Obsidian vault export, remediation mapping
Intelligence	None	CVE correlator (NVD API), attack graph builder (NetworkX), methodology tracker
CLI	`run.py` (starts 2 servers)	`astro serve`, `astro ollama`, `astro tui`, `astro version`
Packaging	`requirements.txt` + `venv`	`pyproject.toml`, installable via `pip install .`
Container	None	Multi-stage Kali Linux Dockerfile, docker-compose for lab environments
LLM support	Claude Desktop only	Any MCP client, plus native Ollama bridge and OpenAI-compatible bridge
Tests	None	pytest suite (unit + integration), ruff, mypy strict

New tools (V2 additions)

Recon: amass, subfinder, ffuf, whatweb, dnsrecon, theharvester, nuclei

Exploitation: searchsploit, crackmapexec, hashcat, responder, smbclient, evil-winrm

Impacket suite: secretsdump, psexec, wmiexec, kerberoast, getnpusers, getst, ticketer

Post-exploitation: linpeas, winpeas, bloodhound, chisel, netcat, msfvenom

Tunneling/C2: burp (proxy integration), certipy (AD CS attacks)

Flex: custom_script (arbitrary bash/python with timeout + sandbox)

Removed

kali_api_server.py — no longer needed; tools execute directly
run.py — replaced by astro CLI
requirements.txt — replaced by pyproject.toml
setup.sh — replaced by pip install . or Docker

Quick start

Docker (recommended)

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "astro": {
      "command": "astro",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}