whit3rabbit0/project_astro

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

46 stars 20 forks 品質 70 トレンド 20

Repository Install

MCP サーバーおよびKali API サーバー - Claude デスクトップの整形

概要

LLM 主導の貫通テストのためのインテリジェンスレイヤー。任意のMCP互換クライアントのための38カリツールラッパー、エンゲージメントトラッキング、スコープの執行、および構造化された出力を備えたMCPサーバーとして出荷します。自分のターゲットに対してのみ使用したり、試験に明示的な認可を持っている。 V1はClaude Desktopとkali api server.pyプロセス間でJSONをシャトルしたフラスコプロキシでした。それは機能しましたが、アーキテクチャは壊れていました - 2つのサーバー、状態無し、安全柵、HTTPエンドポイントにハードワイヤーされた10のツール。 Recon: amass、サブファインダー、ffuf、whatweb、dnsrecon、theharvester、ヌクレア搾取: searchsploit, crackmapexec, ハッシュキャット, 回答者, smbclient, 悪winrm Impacketスイート:secretsdump、psexec、wmiexec、kerberoast、getnpusers、getst、ticketer 後搾: linpeas、winpeas、血中、chisel、netcat、msfvenom Tunneling/C2: burp (プロキシ統合)、certipy (AD CS攻撃)

概要（AI 翻訳）

LLM 主導の貫通テストのためのインテリジェンスレイヤー。任意のMCP互換クライアントのための38カリツールラッパー、エンゲージメントトラッキング、スコープの執行、および構造化された出力を備えたMCPサーバーとして出荷します。

これは開発者です。 自分のターゲットに対してのみ使用したり、試験に明示的な認可を持っている。

V1からの変更点

V1は、Claude Desktopとkali_api_server.pyプロセス間でJSONをシャトルしたフラスコプロキシでした。それは機能しましたが、アーキテクチャは壊れていました - 2つのサーバー、状態無し、安全柵、HTTPエンドポイントにハードワイヤーされた10のツール。

V2 はグラウンドアップ書き換えです。

| V1 | V2 | V2 | V2 | V1 | V2 | V2 | V2 | V1 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V1 | V2 | V2 | V1 | V2 | V2 | V2 | V2 | V1 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | V2 | は | お問い合わせ |アーキテクチュア | フラスコAPI + MCPシム(2プロセス) | シングルファストMCPサーバー([mcp)SDK | |トランスポート | HTTPのみ | ストリーミング可能なHTTPまたはstdio | |ツール | 1つのファイルで10のインライン | 38のラッパー(+カスタムスクリプトの実行者) | | ツール検証 | なし — シェルへの未加工文字列 | ピダンティックベースの検証、シェルメタキャラクタブロック、ブロックされたフラグリスト | |スコープの執行 | なし | CIDR + ドメインの割り当ては YAML 設定で行います。全てのツール呼び出しはチェック | | ※レイト・リミット** | なし | パーツール・アシミフォーム | |Auth | なし | 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 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)

GitHub で README 全文を見る

インストール

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"]
    }
  }
}