Correctover MCS v3.0 — MCP Server Security Boundary Scanner. Automated vulnerability audit for the Model Context Protocol ecosystem.
Project description
Correctover-MCS v3.0.0
MCP Server Security Boundary Scanner — Automated vulnerability audit for the Model Context Protocol ecosystem
What is MCS?
Correctover-MCS (MCP Scanner) is an automated security scanner that audits MCP (Model Context Protocol) servers for vulnerabilities. It identifies security boundary violations, injection points, privilege escalation paths, and data exfiltration risks in MCP server implementations.
Built on CCS verification principles — every finding is backed by code-level evidence and reproducible PoC.
Core Capabilities
- Automated Audit: Scan any MCP server implementation for known vulnerability patterns
- Signature Engine: 50+ vulnerability signatures across SSRF, RCE, auth bypass, data exposure
- Code Analysis: Static analysis + dynamic testing with containerized sandboxes
- CVSS Scoring: Automated severity classification with CVSS v3.1 scoring
- Report Generation: Professional audit reports with PoC, impact analysis, and remediation
Quick Start
pip install correctover-mcs
Scan a target
# Scan a GitHub repository
ccs-scan scan --repo https://github.com/example/mcp-server
# Scan a PyPI package
ccs-scan scan --pypi mcp-server-example
# Scan with custom signatures
ccs-scan scan --repo https://github.com/example/mcp-server --signatures custom-sigs/
# Generate full report
ccs-scan scan --repo https://github.com/example/mcp-server --report full --format pdf
API Usage
from ccs_scanner import MCPServerScanner
scanner = MCPServerScanner()
results = scanner.scan_repo("https://github.com/example/mcp-server")
for vuln in results.vulnerabilities:
print(f"[{vuln.cvss}] {vuln.title}")
print(f" File: {vuln.file_path}:{vuln.line}")
print(f" PoC: {vuln.poc_code}")
Vulnerability Categories
| Category | Signature Count | Max CVSS | Examples |
|---|---|---|---|
| SSRF | 12 | 9.3 | URL parameter injection, proxy abuse |
| RCE | 8 | 9.8 | Container escape, command injection |
| Auth Bypass | 10 | 9.1 | Token timing attack, missing auth |
| Data Exposure | 7 | 8.8 | Sensitive path access, no ACL |
| Supply Chain | 6 | 8.6 | Unsigned images, dependency confusion |
| DoS | 5 | 7.5 | Resource exhaustion, infinite loops |
Architecture
┌─────────────────────────────────────────┐
│ MCS Scanner v3.0.0 │
│ ┌──────────┬──────────┬──────────────┐ │
│ │ Target │ Signature│ Code │ │
│ │ Fetcher │ Engine │ Analyzer │ │
│ ──────────┴──────────┴──────────────┘ │
│ ┌──────────┬──────────┬──────────────┐ │
│ │ Sandbox │ CVSS │ Report │ │
│ │ Executor │ Scorer │ Generator │ │
│ └──────────┴──────────┴──────────────┘ │
└─────────────────────────────────────────┘
Performance
| Metric | Value |
|---|---|
| Scan time (avg repo) | 45-120s |
| Signatures loaded | 50+ |
| False positive rate | <5% |
| True positive rate | >90% (verified) |
Deployment
Local
pip install correctover-mcs
ccs-scan scan --repo <target>
Docker
FROM python:3.12-slim
RUN pip install correctover-mcs
ENTRYPOINT ["ccs-scan"]
docker build -t correctover-mcs .
docker run correctover-mcs scan --repo <target>
License
MIT — © 2026 Correctover. All rights reserved.
Contact
- Website: correctover.com
- Email: wangguigui@correctover.com
- GitHub: github.com/Correctover
Project details
Release history Release notifications | RSS feed
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 correctover_mcp_scanner-3.0.0.tar.gz.
File metadata
- Download URL: correctover_mcp_scanner-3.0.0.tar.gz
- Upload date:
- Size: 29.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b86fca934fa465bea54e8985544e6c243c6a08bfff7b67afad8fbdcd1de4147
|
|
| MD5 |
c3063c0ae6a433d87b7dfb03eb777225
|
|
| BLAKE2b-256 |
827ec170a3588a9b0a389c188fa5f9f68b51e170d2efe4b4ec69b5f7774f4e33
|
File details
Details for the file correctover_mcp_scanner-3.0.0-py3-none-any.whl.
File metadata
- Download URL: correctover_mcp_scanner-3.0.0-py3-none-any.whl
- Upload date:
- Size: 33.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e2cb5bd4e822de42b79280a04505be10768fe2f072e62078f1063335fd024599
|
|
| MD5 |
9f8705537f1e23cc653596624f0c425c
|
|
| BLAKE2b-256 |
be5de9a73593ddc4600724964b79b60180a5dc4a63821e87d28d5932d8fc9946
|