Skip to main content

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 nobody-pentest-mcp

# Using your own API key (for external endpoints)
claude mcp add nobody-pentest nobody-pentest-mcp -e NOBODY_API_KEY=sk-nobody-xxx

Manual Setup

# Install dependencies
pip install mcp httpx python-nmap

# Configure (optional for Nobody AI endpoint)
cp .env.example .env
# Edit .env if needed

# Run server
nobody-pentest-mcp

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

nobody_pentest_mcp-2.0.1.tar.gz (36.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nobody_pentest_mcp-2.0.1-py3-none-any.whl (21.0 kB view details)

Uploaded Python 3

File details

Details for the file nobody_pentest_mcp-2.0.1.tar.gz.

File metadata

  • Download URL: nobody_pentest_mcp-2.0.1.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

Hashes for nobody_pentest_mcp-2.0.1.tar.gz
Algorithm Hash digest
SHA256 dfe0f3a3ad37cbebf4d830f88d83e211482211fbaf41490b824d99242e5fb61d
MD5 a8310c1c4bb4cc5dda5aba035c70c920
BLAKE2b-256 a84d704475685bddab0bc0b426a690824dfd438c478cb89400507d3050ba60d8

See more details on using hashes here.

File details

Details for the file nobody_pentest_mcp-2.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for nobody_pentest_mcp-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1a56a266cf89542fba5732ee72854cd8daaa46a9a6c100d55bbf29c230c47242
MD5 51b6405bff30fe1b1d0860ac415ee587
BLAKE2b-256 15d71881bf995719e58e4e222ad6e50c543365bf7b1eeadc4773353edba52f4a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page