MCP server for Nobody AI Pentest Engine v2 — real tool execution (nmap, httpx, CVE APIs) via Claude Code
Project description
Nobody Pentest MCP Server v2
MCP server yang menghubungkan Claude Code dengan Nobody AI Pentest Engine. v2: Real tool execution -- tools dijalankan secara lokal, bukan hanya prompt ke API.
Features
Real Executors (lokal, tidak perlu API)
- port_scan: nmap port scan + service detection + vuln suggestions
- web_audit: technology detection, security headers, misconfigs, dir enumeration, SQLi/XSS indicators
- cve_search: CVE databases (NIST NVD + circl.lu) + exploit references
- payload_gen: reverse shell, bind shell, web shell, SQLi, XSS, command injection templates
AI-Based (via Nobody API)
- exploit_gen: AI-generated exploit code
- code_audit: AI-powered SAST
- report: AI-formatted pentest report
- custom: AI general pentest
Quick Setup
Install (Recommended)
pip install nobody-pentest-mcp
Add to Claude Code
# Using default Nobody AI endpoint (API key optional)
claude mcp add nobody-pentest python -m nobody_pentest_mcp.server
# Using your own API key (for external endpoints)
claude mcp add nobody-pentest python -m nobody_pentest_mcp.server -e NOBODY_API_KEY=sk-nobody-xxx
Manual Setup
# Install dependencies
pip install mcp httpx python-nmap
# Run server
python -m nobody_pentest_mcp.server
Requirements
- Python 3.10+
- nmap (for port scanning) -- https://nmap.org/download.html
- mcp pip package
- httpx pip package
- python-nmap pip package (optional, nmap CLI works too)
- NOBODY_API_KEY (optional for Nobody AI endpoint, required for external endpoints)
API Key
Using Default Nobody AI Endpoint (v2.nobody0x.com)
API key is optional. The default endpoint handles authentication automatically.
# Just install and use
pip install nobody-pentest-mcp
claude mcp add nobody-pentest nobody-pentest-mcp
Using External Endpoints (OpenAI, DeepSeek, etc.)
API key is required. Set it via environment variable or .env file.
# Set API key
export NOBODY_API_KEY=sk-your-key-here
# Or use .env file
echo "NOBODY_API_KEY=sk-your-key-here" > .env
Architecture
User (Claude Code)
| MCP protocol (tool call)
Nobody Pentest MCP Server (local)
|-- REAL EXECUTION: nmap, httpx, CVE APIs, templates
|-- AI EXECUTION: POST /v1/messages -> DeepSeek
v
Results returned to Claude Code
Tools
| Tool | Executor | API Required |
|---|---|---|
nobody_pentest_scan |
nmap (local) | No |
nobody_pentest_web_audit |
httpx + manual checks (local) | No |
nobody_pentest_cve_search |
NVD + circl.lu APIs (local) | No |
nobody_pentest_payload_gen |
Templates (local) | No |
nobody_pentest_exploit_gen |
Nobody AI API | Yes (external only) |
nobody_pentest_code_audit |
Nobody AI API | Yes (external only) |
nobody_pentest_report |
Nobody AI API | Yes (external only) |
nobody_pentest_custom |
Nobody AI API | Yes (external only) |
Environment Variables
| Variable | Default | Description |
|---|---|---|
NOBODY_API_KEY |
(none) | API key (optional for Nobody AI endpoint) |
NOBODY_API_URL |
https://v2.nobody0x.com/v1/messages |
API endpoint |
NOBODY_MODEL |
nobody-pentest |
Model name |
NMAP_PATH |
nmap |
Path to nmap binary |
SCAN_TIMEOUT |
300 |
Max scan time in seconds |
HTTP_TIMEOUT |
15.0 |
HTTP request timeout |
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nobody_pentest_mcp-2.0.3.tar.gz.
File metadata
- Download URL: nobody_pentest_mcp-2.0.3.tar.gz
- Upload date:
- Size: 36.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c9b0b0cc38c49024ddf70050f398259d1b657caf60170215e6d743c5c66ccfd
|
|
| MD5 |
0a7f11f4c7e76f5e80a79a2ea21779ad
|
|
| BLAKE2b-256 |
7e837f29e25168de3f7590dd6c34fec5931fa168e6e6350edbcb3cce14346649
|
File details
Details for the file nobody_pentest_mcp-2.0.3-py3-none-any.whl.
File metadata
- Download URL: nobody_pentest_mcp-2.0.3-py3-none-any.whl
- Upload date:
- Size: 21.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebbe7b442463b8f449640dfb66c6d468af864c99d01b70f04b022bdef03ac2a1
|
|
| MD5 |
e866db594e03f3db9c0c75dc42c0f9be
|
|
| BLAKE2b-256 |
ffc332a7d182627ff16e170892ee1128e475c2a3818034cfc0e7b48c429bf648
|