Metadata-Version: 2.4
Name: nobody-pentest-mcp
Version: 1.0.0
Summary: MCP server for Nobody AI Pentest Engine — autonomous security testing via Claude Code
Project-URL: Homepage, https://nobody0x.com/pentest-docs
Project-URL: Documentation, https://nobody0x.com/pentest-docs
Project-URL: Repository, https://github.com/nobody0x/nobody-pentest-mcp
Project-URL: Issues, https://github.com/nobody0x/nobody-pentest-mcp/issues
Author-email: Nobody AI <admin@nobody0x.com>
License: MIT
License-File: LICENSE
Keywords: ai,claude,exploit,mcp,pentest,security,vulnerability
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# Nobody Pentest MCP Server

MCP server yang menghubungkan Claude Code dengan Nobody AI Pentest Engine.

## ⚡ Quick Setup (1 Command)

```bash
cd mcp-pentest
python setup.py --api-key sk-nobody-xxx
```

Script akan otomatis:
1. ✅ Install dependencies (`mcp`, `httpx`)
2. ✅ Update `.env` dengan API key
3. ✅ Update Claude Code `settings.json`

Lalu **restart Claude Code** dan langsung bisa dipake.

---

## 📋 Manual Setup

Jika auto-setup tidak berfungsi:

### 1. Install Dependencies
```bash
pip install mcp httpx
```

### 2. Configure API Key
```bash
cp .env.example .env
# Edit .env, isi NOBODY_API_KEY=sk-nobody-xxx
```

### 3. Add to Claude Code

**Option A: CLI**
```bash
claude mcp add nobody-pentest python /path/to/mcp-pentest/server.py -e NOBODY_API_KEY=sk-nobody-xxx
```

**Option B: Manual edit settings.json**
```json
{
  "mcpServers": {
    "nobody-pentest": {
      "command": "python",
      "args": ["/path/to/mcp-pentest/server.py"],
      "env": {
        "NOBODY_API_KEY": "sk-nobody-xxx"
      }
    }
  }
}
```

---

## 🔧 Available Tools

| Tool | Description |
|---|---|
| `nobody_pentest_scan` | Port scan & service detection |
| `nobody_pentest_web_audit` | Web app vulnerability audit |
| `nobody_pentest_cve_search` | CVE & exploit search |
| `nobody_pentest_exploit_gen` | Generate exploit scripts |
| `nobody_pentest_payload_gen` | Generate payloads (reverse shell, etc) |
| `nobody_pentest_code_audit` | Source code security audit (SAST) |
| `nobody_pentest_report` | Generate pentest report |
| `nobody_pentest_custom` | Custom pentest request |

## 🚀 Usage in Claude Code

Setelah setup, langsung pakai di Claude Code:

```
> Scan 192.168.1.1 for open ports
> Audit example.com for SQL injection
> Search CVEs for nginx 1.18
> Generate reverse shell payload for Linux
> Audit this PHP code for vulnerabilities
> Generate pentest report from these findings
```

Claude Code akan otomatis memanggil tool yang sesuai.

## 🏗️ Architecture

```
User (Claude Code)
    ↓ MCP protocol (tool call)
Nobody Pentest MCP Server (local)
    ↓ HTTP POST
v2.nobody0x.com/v1/messages
    ↓ Anthropic Router (3-layer pipeline)
DeepSeek Backend
    ↓ Response
Claude Code ← Hasil pentest
```

## 📁 File Structure

```
mcp-pentest/
├── server.py        ← MCP server (8 tools)
├── setup.py         ← Auto-setup script
├── .env.example     ← Config template
├── .env             ← Your config (gitignored)
└── README.md        ← This file
```
