Skip to main content
Glama
banhongit7

va-pentest-mcp

by banhongit7

VA Pentest MCP - Vulnerability Assessment & Penetration Testing MCP Server

šŸ”’ Model Context Protocol (MCP) Server for Security Vulnerability Assessment and Penetration Testing

A comprehensive Python-based MCP server that provides automated security scanning capabilities for projects. Combines OWASP Dependency-Check for dependency scanning with custom code vulnerability detection.

Features

šŸ” Security Scanning

  • Dependency Scanning: Uses OWASP Dependency-Check to identify known vulnerabilities in project dependencies

  • Code Security Scanning: Custom regex-based vulnerability detection for:

    • šŸ” Hardcoded Secrets (API keys, passwords, private keys, JWT tokens, database URLs, AWS credentials)

    • šŸ’‰ SQL Injection patterns

    • šŸŽÆ Command Injection vulnerabilities

    • āš ļø Unsafe Operations (eval, pickle, dangerous imports, file permissions)

    • 🌐 Cross-Site Scripting (XSS) vulnerabilities

    • 🚶 Path Traversal vulnerabilities

šŸ“Š Report Generation

  • HTML Reports: Beautiful, interactive HTML reports with vulnerability details and recommendations

  • JSON Reports: Machine-readable JSON format for integration with other systems

  • Comprehensive Summary: Risk assessment and vulnerability statistics

šŸ› ļø MCP Protocol Support

  • Full Model Context Protocol implementation

  • Tool registration and management

  • Resource handling

  • Standardized request/response format

Related MCP server: Socket MCP Server

Installation

Prerequisites

  • Python 3.8 or higher

  • pip (Python package manager)

  • OWASP Dependency-Check (optional - will attempt auto-install)

Setup

  1. Clone the repository

git clone https://github.com/banhongit7/va-pentest-mcp.git
cd va-pentest-mcp
  1. Create virtual environment

python -m venv venv

# On Windows
venv\Scripts\activate

# On macOS/Linux
source venv/bin/activate
  1. Install dependencies

pip install -r requirements.txt
  1. Install package

pip install -e .

Configuration

Environment Variables

Create a .env file in the project root:

# MCP Server Configuration
LOG_LEVEL=INFO
LOG_FILE=./logs/va-pentest-mcp.log

# Dependency Check Configuration
DEPENDENCY_CHECK_ENABLED=true
DEPENDENCY_CHECK_PATH=/path/to/dependency-check/bin/dependency-check
DEPENDENCY_CHECK_DB_DIR=./tools/dependency-check-db

# Code Scanner Configuration
CODE_SCANNER_ENABLED=true
SCAN_FOR_SECRETS=true
SCAN_FOR_SQL_INJECTION=true
SCAN_FOR_COMMAND_INJECTION=true
SCAN_FOR_UNSAFE_OPERATIONS=true

# Report Generation
GENERATE_HTML_REPORT=true
GENERATE_JSON_REPORT=true

# Python Path (for Windows)
PYTHONPATH=D:\mcp\va-pentest-mcp\src

MCP Configuration (config.json)

For OpenCode AI integration:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "va-pentest-mcp": {
      "type": "local",
      "command": ["python", "-m", "va_pentest_mcp.server"],
      "enabled": true,
      "env": {
        "PYTHONPATH": "D:\\mcp\\va-pentest-mcp\\src",
        "PATH": "D:\\mcp\\va-pentest-mcp\\tools;{env:PATH}"
      }
    }
  }
}

Usage

Starting the Server

python -m va_pentest_mcp.server

Or using the console script:

va-pentest-mcp

Available Tools

1. scan_dependencies

Scans project dependencies for known vulnerabilities using OWASP Dependency-Check.

{
  "project_path": "/path/to/project"
}

2. scan_code

Scans source code for security vulnerabilities.

{
  "project_path": "/path/to/project",
  "file_extensions": [".py", ".js", ".java"]  # Optional
}

3. scan_full

Runs complete security scan and generates reports.

{
  "project_path": "/path/to/project",
  "generate_reports": true
}

Project Structure

va-pentest-mcp/
ā”œā”€ā”€ src/
│   └── va_pentest_mcp/
│       ā”œā”€ā”€ __init__.py                 # Package initialization
│       ā”œā”€ā”€ server.py                   # Main MCP Server
│       ā”œā”€ā”€ mcp_protocol.py             # MCP Protocol Handler
│       ā”œā”€ā”€ dependency_scanner.py       # OWASP Dependency-Check Integration
│       ā”œā”€ā”€ code_scanner.py             # Custom Security Vulnerability Detection
│       ā”œā”€ā”€ report_generator.py         # HTML & JSON Report Generation
│       ā”œā”€ā”€ config.py                   # Configuration Management
│       └── utils.py                    # Utility Functions
ā”œā”€ā”€ tools/                              # External tools directory
│   ā”œā”€ā”€ dependency-check/               # OWASP Dependency-Check binary
│   └── dependency-check-db/            # Vulnerability database
ā”œā”€ā”€ reports/                            # Generated reports
│   ā”œā”€ā”€ scan_report_YYYYMMDD_HHMMSS.html
│   └── scan_report_YYYYMMDD_HHMMSS.json
ā”œā”€ā”€ logs/                               # Application logs
ā”œā”€ā”€ requirements.txt                    # Python dependencies
ā”œā”€ā”€ setup.py                            # Package setup script
ā”œā”€ā”€ README.md                           # This file
└── .gitignore                          # Git ignore rules

Vulnerability Detection

Hardcoded Secrets Detection

Detects:

  • API Keys

  • Passwords

  • Private Keys (RSA, OPENSSH, DSA, EC)

  • AWS Access Keys (AKIA...)

  • JWT Tokens

  • Database Connection Strings

Code Injection Detection

  • SQL Injection via string concatenation, format strings, and direct queries

  • Command Injection via os.system, subprocess, shell commands

Unsafe Operations

  • eval() usage

  • pickle/marshal usage

  • Dangerous imports

  • Insecure file permissions

Web Vulnerabilities

  • XSS via innerHTML, dangerouslySetInnerHTML

  • Path Traversal patterns

Report Output

HTML Report Features

  • Executive Summary with Risk Assessment

  • Vulnerability Statistics by Severity

  • Detailed Vulnerability Listing

  • Code Snippets with Line Numbers

  • Remediation Recommendations

  • Professional Styling

JSON Report Structure

{
  "scan_info": {
    "timestamp": "2024-01-01T12:00:00",
    "project_path": "/path/to/project",
    "scan_type": "Combined VA Scan"
  },
  "code_scan": {
    "total_vulnerabilities": 5,
    "vulnerabilities": [
      {
        "type": "Hardcoded Secret",
        "severity": "CRITICAL",
        "file": "config.py",
        "line": 42,
        "description": "Hardcoded API Key detected",
        "recommendation": "Use environment variables instead"
      }
    ]
  },
  "summary": {
    "overall_risk": "HIGH",
    "critical": 2,
    "high": 3
  }
}

Advanced Configuration

Custom File Extensions

file_extensions = ['.py', '.js', '.ts', '.java', '.go', '.rb', '.php', '.cs']

Severity Levels

  • CRITICAL: Immediate action required

  • HIGH: Significant security risk

  • MEDIUM: Moderate risk, should be addressed

  • LOW: Low risk, consider fixing

  • INFO: Informational findings

Troubleshooting

dependency-check Not Found

# Try installing via pip
pip install dependency-check

# Or via npm
npm install -g dependency-check

# Or via homebrew (macOS)
brew install dependency-check

Permission Issues

# Make dependency-check executable
chmod +x /path/to/dependency-check

Windows Python Path

Ensure PYTHONPATH is correctly set in config.json:

"PYTHONPATH": "C:\\Users\\username\\va-pentest-mcp\\src"

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - See LICENSE file for details

Security Note

This tool is designed for authorized security testing only. Always get proper authorization before testing security vulnerabilities in any system.

Support

For issues, questions, or suggestions:


VA Pentest MCP - Making security assessment automated and accessible šŸš€

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server providing security vulnerability intelligence tools including CVE lookup, EPSS scoring, CVSS calculation, exploit detection, and Python package vulnerability checking.
    8
    9
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    A Model Context Protocol (MCP) server for Socket integration, allowing AI assistants to efficiently check dependency vulnerability scores and security information.
    1
    1,524
    126
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Model Context Protocol server for security research automation, integrating multiple security testing tools into LLM-driven workflows for secret scanning, static analysis, and vulnerability discovery.
    53
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    Comprehensive dependency audit MCP server supporting 9 languages and 23 tools for scanning, updating, security auditing, and migration detection.
    25
    7
    MIT

View all related MCP servers

Related MCP Connectors

  • Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.

  • Zero-config MCP security scanner for AI-generated apps. 25K+ vulnerability patterns.

  • Scan any public GitHub MCP-server repo for security issues. 37 MCP-specific L1 rules, 8 languages.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/banhongit7/va-pentest-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server