@cyanheads/pentest-mcp-server

security MCP Server

Offline methodology engine and payload workshop for authorized penetration testing, CTF, security research, and education via MCP. STDIO or Streamable HTTP.

VerifiedInstall Ready
securitysecurity
1 views1 stars1 forksv0.1.8Apache-2.0

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 2w ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
1
Last synced
2w ago
Install
Instructions detected

Install

1. Install the package

bunx @cyanheads/pentest-mcp-server@latest

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "cyanheads-pentest-mcp-server": {
      "command": "bunx",
      "args": [
        "@cyanheads/pentest-mcp-server@latest"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

15
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (15)

MCP_LOG_LEVEL

Log level: `debug`, `info`, `notice`, `warning`, `error`.

MCP_TRANSPORT_TYPE

Transport: `stdio` or `http`.

Tool

Description

MCP_HTTP_PORT

Port for HTTP server.

pentest_guide

Returns a step-by-step methodology playbook for the given attack vector, scoped to authorized testing. Each phase covers what to look for, tools, detection indicators for defenders, and mitigations.

MCP_AUTH_MODE

Auth mode: `none`, `jwt`, or `oauth`.

pentest_lookup_technique

Looks up a MITRE ATT&CK technique by ID or keyword. Returns description, tactics, detection data sources, behavioral indicators, mitigations, and real-world procedure examples.

LOGS_DIR

Directory for log files (Node.js only).

pentest_map_techniques

Given a target profile (stack, services, auth type, OS), returns ranked ATT&CK techniques and OWASP test cases most relevant to that authorized engagement.

OTEL_ENABLED

Enable OpenTelemetry instrumentation (spans, metrics, completion logs).

pentest_encode

Applies an encoding chain to a payload string (URL, double-URL, HTML entity, Unicode, hex, Base64, and more). Returns step-by-step decode explanation and bypass rationale.

Variable

Description

pentest_analyze_response

Analyzes a raw server response (headers + body) from authorized probing for information leakage, fingerprinting signals, and exploitation opportunities — each finding paired with remediation.

pentest_lookup_group

Looks up a MITRE ATT&CK threat group or software entry by ID or name. Returns aliases, type (group vs. software), description, and the techniques it uses with procedure context.

pentest_generate_payloads

Generates annotated payload templates for authorized testing. Each template includes why it works in the injection context, detection signatures, and mitigations.