whit3rabbit0/project_astro
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP 서버 및 Kali API 서버 - Claude 데스크탑 Integ
개요
LLM 구동 침투 테스트를 위한 지능 레이어. 38 Kali 도구 래퍼, 참여 추적, 범위 시행 및 MCP 호환 클라이언트에 대한 구조 출력을 가진 MCP 서버로 배송합니다. 테스트에 명시된 권한이 있는 대상에 대해서만 사용하십시오. V1은 Claude Desktop과 kali api server.py 프로세스 사이에 JSON을 셔틀 한 Flask 프록시였습니다. 그것은 일했지만, 아키텍처는 fragile이었다 — 두 서버, 아니 상태, 아니 안전 레일, 10 도구는 하드 와이어 HTTP 엔드 포인트. 재구성: amass, subfinder, ffuf, whatweb, dnsrecon, theharvester, nuclei 폭발: 검색, crackmapexec, hashcat, 응답자, smbclient, 악-winrm Impacket 스위트: secretsdump, psexec, wmiexec, kerberoast, getnpusers, getst, 마커 포스트 폭발 : linpeas, winpeas, Bloodhound, chisel, netcat, msfvenom Tunneling/C2: burp (proxy integration), certipy (AD CS 공격)
개요(AI 번역)
LLM 구동 침투 테스트를 위한 지능 레이어. 38 Kali 도구 래퍼, 참여 추적, 범위 시행 및 MCP 호환 클라이언트에 대한 구조 출력을 가진 MCP 서버로 배송합니다.
이 devkit입니다. 테스트에 명시된 권한이 있는 대상에 대해서만 사용하십시오.
V1에서 변경되는 것
V1은 Claude Desktop과 kali_api_server.py] 프로세스 사이에 JSON을 셔틀 한 Flask 프록시였습니다. 그것은 일했지만, 아키텍처는 fragile이었다 — 두 서버, 아니 상태, 아니 안전 레일, 10 도구는 하드 와이어 HTTP 엔드 포인트.
V2는 지상 업 리깅:
| V1 | V2 | V1 | V2 | V1 | V2 | V1 | V2 | V1 | V2 | V2 | V2 | V1 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 |
|—|||||
|Architecture | 플라스크 API + MCP shim (2개의 프로세스) | Single FastMCP 서버(mcp SDK) |
| Transport | HTTP만 | Streamable-HTTP 또는 stdio |
|Tools | 10, inline in one file | 38 래퍼(Custom script executor), 각각 src/astro/tools/ |
|Tool validation | none - 쉘에 원시 문자열 | Pydantic-based validation, shell metacharacter blocking, blocked-flag list |
|Scope Conductment | none | YAML config를 통해 CIDR + 도메인 허용 목록
| ** 제한 ** | 없음 | Per-tool async semaphore |
|Auth | none | API 키 + OIDC 지원 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
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 directlyrun.py— replaced byastroCLIrequirements.txt— replaced bypyproject.tomlsetup.sh— replaced bypip install .or Docker
Quick start
Docker (recommended)
설치
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"]
}
}
}