MCP Nuclei Server
A Nuclei security scanning server based on MCP (Model Control Protocol), providing convenient vulnerability scanning services.
Project Introduction
MCP Nuclei Server is a Nuclei security scanning service developed based on the MCP protocol. It allows large language models to execute Nuclei security scans, supporting various scanning options and result output formats.
Key Features:
- Support for Nuclei security scanning
- Configurable template and tag filtering
- Support for severity-based vulnerability filtering
- JSON format output results
- Easy-to-integrate MCP service
Installation Guide
Prerequisites
- Python 3.8 or higher
- Nuclei binary (installed and configured)
Installation Steps
- Clone the repository:
git clone https://github.com/crazyMarky/mcp_nuclei_server.git
cd mcp_nuclei_server
- Install UV and activate environment:
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
- Install dependencies:
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install mcp related packages
uv pip install mcp
Usage Guide
MCP Configuration (Example for CLINE)
- Reference MCP JSON configuration:
{
"mcpServers": {
"nuclei_mcp_server": {
"command": "/path/to/uv", # path to uv
"args": [
"--directory",
"/path/to/nuclei_mcp_server/",
"run",
"main.py"
],
"env": {
"NUCLEI_BIN_PATH": "/path/to/nuclei"
}
}
}
}
Usage Example
Parameter Description
target: Target URL or IP addresstemplates: List of specific templates to use (optional)severity: Vulnerability severity filter (critical, high, medium, low, info)template_tags: Template tag filter (optional)output_format: Output format (default: "json")
Output Format
Scan results are returned in JSON format with the following fields:
{
"success": true,
"target": "https://example.com",
"time_cost_seconds": 10.5,
"results": [
{
"template": "template-name",
"severity": "high",
"matched_at": "https://example.com/path",
"info": {
"name": "Vulnerability Name",
"description": "Vulnerability Description"
}
}
]
}
Contributing
Issues and Pull Requests are welcome!
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details
Contact
For any questions or suggestions, please contact us through:
- Submit an Issue
Metadata
Release files for iflow-mcp_crazymarky-mcp_nuclei_server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.tar.gz | 318.9 kB | Without provenance | Details for iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0-py3-none-any.whl |
Total release size: 643.1 kB
Release files / iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.tar.gz
| Download URL | iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.tar.gz |
|---|---|
| Size | 318.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1dfc7e6a900c5e791edf7a8071f8098fca096b3fd863cf39dd97e0aebdb2ede2
|
|
BLAKE2b-256 checksum How to use checksums |
da5815e93ba2d784e1e03675ceaf99e978a216efcb4759c59ce98078625974ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 324.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8159517d2cdaee7d2290993396eb30ff7ec8577495e0d9063740c4d117ddeec
|
|
BLAKE2b-256 checksum How to use checksums |
8631d08240328a0122103b91fdf77c9e7db1dbaa80cd01a74b301f700e68d2ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_crazymarky-mcp_nuclei_server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.