VulniCheck - AI-Powered Security Scanner

VulniCheck provides comprehensive security analysis for Python projects and GitHub repositories using AI-powered vulnerability detection. It runs as a Docker-based HTTP MCP server with standard HTTP streaming (no SSE required), providing secure containerized deployment with comprehensive vulnerability scanning capabilities.

Quick Start

1. Pull and Run the Docker Container

# Pull the latest image from Docker Hub
docker pull andrasfe/vulnicheck:latest

# Run with OpenAI API key (for enhanced AI-powered risk assessment)
docker run -d --name vulnicheck-mcp -p 3000:3000 \
  --restart=unless-stopped \
  -e OPENAI_API_KEY=your-openai-api-key \
  andrasfe/vulnicheck:latest

# Or run without API key (basic vulnerability scanning)
docker run -d --name vulnicheck-mcp -p 3000:3000 \
  --restart=unless-stopped \
  andrasfe/vulnicheck:latest

2. Add to Claude Code

claude mcp add --transport http vulnicheck http://localhost:3000/mcp

That's it! VulniCheck is now available in Claude Code.

Usage

Once installed, simply ask Claude:

"Run a comprehensive security check on my project"

"Scan https://github.com/owner/repo for vulnerabilities"

"Check my dependencies for security issues"

"Scan my Dockerfile for vulnerable packages"

VulniCheck will: - ✅ Scan dependencies for known vulnerabilities (requirements.txt, pyproject.toml, setup.py) - ✅ Detect exposed secrets and credentials - ✅ Analyze Dockerfiles for security issues - ✅ Validate MCP configurations - ✅ Generate AI-powered risk assessments - ✅ Provide actionable remediation recommendations

Key Features

• Docker Deployment: Secure containerized deployment with HTTP streaming (no SSE/Server-Sent Events required)
• Production Ready: Scalable HTTP server architecture
• Comprehensive Coverage: Queries 5+ vulnerability databases (OSV.dev, NVD, GitHub Advisory, CIRCL, Safety DB)
• GitHub Integration: Scan any public/private GitHub repository directly (up to 1GB)
• AI-Powered Analysis: Uses OpenAI/Anthropic APIs for intelligent security assessment
• Secrets Detection: Finds exposed API keys, passwords, and credentials
• Docker Security: Analyzes Dockerfiles for vulnerable dependencies
• Smart Caching: Avoids redundant scans with commit-level caching
• Space Management: Automatic cleanup prevents disk exhaustion (2GB total limit)
• Zero Config: Works out of the box, enhanced with optional API keys

Available Tools

Tool	Description
check_package_vulnerabilities	Check a specific Python package for vulnerabilities
scan_dependencies	Scan dependency files (requirements.txt, pyproject.toml, etc.)
scan_installed_packages	Scan currently installed Python packages
get_cve_details	Get detailed information about a specific CVE
scan_for_secrets	Detect exposed secrets and credentials in code
scan_dockerfile	Analyze Dockerfiles for vulnerable Python dependencies
scan_github_repo	Comprehensive security scan of GitHub repositories
assess_operation_safety	AI-powered risk assessment for operations
validate_mcp_security	Validate MCP server security configurations
comprehensive_security_check	Interactive AI-powered security assessment

Optional API Keys

Enhance VulniCheck with API keys for better rate limits and AI features:

docker run -d --name vulnicheck-mcp -p 3000:3000 \
  --restart=unless-stopped \
  -e OPENAI_API_KEY=your-key \           # AI-powered risk assessment
  -e ANTHROPIC_API_KEY=your-key \        # Alternative AI provider
  -e GITHUB_TOKEN=your-token \           # Higher GitHub API rate limits
  -e NVD_API_KEY=your-key \              # Higher NVD rate limits
  andrasfe/vulnicheck:latest

Building from Source

# Clone the repository
git clone https://github.com/andrasfe/vulnicheck.git
cd vulnicheck

# Build Docker image
docker build -t vulnicheck .

# Run locally built image
docker run -d --name vulnicheck-mcp -p 3000:3000 --restart=unless-stopped vulnicheck

Docker Hub

The official Docker image is available at: - Docker Hub: andrasfe/vulnicheck - Latest Tag: andrasfe/vulnicheck:latest

Requirements

• Docker
• Claude Code or any MCP client with HTTP transport support (standard HTTP, no SSE required)
• Optional: API keys for enhanced features

Supported File Types

• Dependencies: requirements.txt, pyproject.toml, setup.py, lock files
• Containers: Dockerfile, docker-compose.yml
• Secrets: All text-based source files
• GitHub: Any public or private repository URL

Support

• Issues: Report problems at https://github.com/andrasfe/vulnicheck/issues
• Development: See CLAUDE.md for development details
• Security: Report security issues privately via GitHub Security Advisories

---

DISCLAIMER: Vulnerability data provided "AS IS" without warranty. Users are responsible for verification and remediation.