iflow-mcp_crazymarky-mcp_nuclei_server 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- .gitignore +3 -0
- 3170_process.log +6 -0
- DOCS//347/244/272/344/276/213.jpeg +0 -0
- PKG-INFO +138 -0
- README.md +128 -0
- README.zh-cn.md +125 -0
- iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/METADATA +138 -0
- iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/RECORD +15 -0
- iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/WHEEL +4 -0
- iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/entry_points.txt +2 -0
- language.json +1 -0
- main.py +144 -0
- package_name +1 -0
- push_info.json +5 -0
- pyproject.toml +27 -0
.gitignore
ADDED
3170_process.log
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
[2025-02-05] [SUCCESS] 步骤1 - 获取项目: Fork并克隆成功
|
|
2
|
+
github_url: crazyMarky/mcp_nuclei_server
|
|
3
|
+
fork_github_url: https://github.com/iflow-mcp/crazymarky-mcp_nuclei_server
|
|
4
|
+
name: crazymarky-mcp_nuclei_server[2025-02-05] [SUCCESS] 步骤2 - 阅读代码: 项目分析完成，Python语言，MCP服务端项目
|
|
5
|
+
[2025-02-05] [SUCCESS] 步骤3 - 本地测试: 测试通过，发现1个工具
|
|
6
|
+
[2025-02-05] [SUCCESS] 步骤4 - 推送分支: iflow分支推送成功
|
|
Binary file
|
PKG-INFO
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: iflow-mcp_crazymarky-mcp_nuclei_server
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A Nuclei security scanning server based on MCP
|
|
5
|
+
Author: crazyMarky
|
|
6
|
+
License: MIT
|
|
7
|
+
Requires-Python: >=3.8
|
|
8
|
+
Requires-Dist: mcp>=0.9.0
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
|
|
11
|
+
[](https://mseep.ai/app/crazymarky-mcp-nuclei-server)
|
|
12
|
+
|
|
13
|
+
# MCP Nuclei Server
|
|
14
|
+
|
|
15
|
+
[](https://www.python.org/downloads/)
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](https://github.com/crazyMarky/mcp_nuclei_server)
|
|
18
|
+
[](README.zh-cn.md)
|
|
19
|
+
|
|
20
|
+
A Nuclei security scanning server based on MCP (Model Control Protocol), providing convenient vulnerability scanning services.
|
|
21
|
+
|
|
22
|
+
## Project Introduction
|
|
23
|
+
|
|
24
|
+
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.
|
|
25
|
+
|
|
26
|
+
Key Features:
|
|
27
|
+
- Support for Nuclei security scanning
|
|
28
|
+
- Configurable template and tag filtering
|
|
29
|
+
- Support for severity-based vulnerability filtering
|
|
30
|
+
- JSON format output results
|
|
31
|
+
- Easy-to-integrate MCP service
|
|
32
|
+
|
|
33
|
+
## Installation Guide
|
|
34
|
+
|
|
35
|
+
### Prerequisites
|
|
36
|
+
|
|
37
|
+
- Python 3.8 or higher
|
|
38
|
+
- Nuclei binary (installed and configured)
|
|
39
|
+
|
|
40
|
+
### Installation Steps
|
|
41
|
+
|
|
42
|
+
1. Clone the repository:
|
|
43
|
+
```bash
|
|
44
|
+
git clone https://github.com/crazyMarky/mcp_nuclei_server.git
|
|
45
|
+
cd mcp_nuclei_server
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
2. Install UV and activate environment:
|
|
49
|
+
```bash
|
|
50
|
+
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
|
|
51
|
+
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
3. Install dependencies:
|
|
55
|
+
```bash
|
|
56
|
+
# Create and activate virtual environment
|
|
57
|
+
uv venv
|
|
58
|
+
source .venv/bin/activate
|
|
59
|
+
# Install mcp related packages
|
|
60
|
+
uv pip install mcp
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Usage Guide
|
|
64
|
+
|
|
65
|
+
### MCP Configuration (Example for CLINE)
|
|
66
|
+
|
|
67
|
+
1. Reference MCP JSON configuration:
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"mcpServers": {
|
|
71
|
+
"nuclei_mcp_server": {
|
|
72
|
+
"command": "/path/to/uv", # path to uv
|
|
73
|
+
"args": [
|
|
74
|
+
"--directory",
|
|
75
|
+
"/path/to/nuclei_mcp_server/",
|
|
76
|
+
"run",
|
|
77
|
+
"main.py"
|
|
78
|
+
],
|
|
79
|
+
"env": {
|
|
80
|
+
"NUCLEI_BIN_PATH": "/path/to/nuclei"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Usage Example
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
### Parameter Description
|
|
91
|
+
|
|
92
|
+
- `target`: Target URL or IP address
|
|
93
|
+
- `templates`: List of specific templates to use (optional)
|
|
94
|
+
- `severity`: Vulnerability severity filter (critical, high, medium, low, info)
|
|
95
|
+
- `template_tags`: Template tag filter (optional)
|
|
96
|
+
- `output_format`: Output format (default: "json")
|
|
97
|
+
|
|
98
|
+
## Output Format
|
|
99
|
+
|
|
100
|
+
Scan results are returned in JSON format with the following fields:
|
|
101
|
+
|
|
102
|
+
```json
|
|
103
|
+
{
|
|
104
|
+
"success": true,
|
|
105
|
+
"target": "https://example.com",
|
|
106
|
+
"time_cost_seconds": 10.5,
|
|
107
|
+
"results": [
|
|
108
|
+
{
|
|
109
|
+
"template": "template-name",
|
|
110
|
+
"severity": "high",
|
|
111
|
+
"matched_at": "https://example.com/path",
|
|
112
|
+
"info": {
|
|
113
|
+
"name": "Vulnerability Name",
|
|
114
|
+
"description": "Vulnerability Description"
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
]
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## Contributing
|
|
122
|
+
|
|
123
|
+
Issues and Pull Requests are welcome!
|
|
124
|
+
|
|
125
|
+
1. Fork the project
|
|
126
|
+
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
127
|
+
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
128
|
+
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
129
|
+
5. Open a Pull Request
|
|
130
|
+
|
|
131
|
+
## License
|
|
132
|
+
|
|
133
|
+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
|
|
134
|
+
|
|
135
|
+
## Contact
|
|
136
|
+
|
|
137
|
+
For any questions or suggestions, please contact us through:
|
|
138
|
+
- Submit an Issue
|
README.md
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
[](https://mseep.ai/app/crazymarky-mcp-nuclei-server)
|
|
2
|
+
|
|
3
|
+
# MCP Nuclei Server
|
|
4
|
+
|
|
5
|
+
[](https://www.python.org/downloads/)
|
|
6
|
+
[](LICENSE)
|
|
7
|
+
[](https://github.com/crazyMarky/mcp_nuclei_server)
|
|
8
|
+
[](README.zh-cn.md)
|
|
9
|
+
|
|
10
|
+
A Nuclei security scanning server based on MCP (Model Control Protocol), providing convenient vulnerability scanning services.
|
|
11
|
+
|
|
12
|
+
## Project Introduction
|
|
13
|
+
|
|
14
|
+
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.
|
|
15
|
+
|
|
16
|
+
Key Features:
|
|
17
|
+
- Support for Nuclei security scanning
|
|
18
|
+
- Configurable template and tag filtering
|
|
19
|
+
- Support for severity-based vulnerability filtering
|
|
20
|
+
- JSON format output results
|
|
21
|
+
- Easy-to-integrate MCP service
|
|
22
|
+
|
|
23
|
+
## Installation Guide
|
|
24
|
+
|
|
25
|
+
### Prerequisites
|
|
26
|
+
|
|
27
|
+
- Python 3.8 or higher
|
|
28
|
+
- Nuclei binary (installed and configured)
|
|
29
|
+
|
|
30
|
+
### Installation Steps
|
|
31
|
+
|
|
32
|
+
1. Clone the repository:
|
|
33
|
+
```bash
|
|
34
|
+
git clone https://github.com/crazyMarky/mcp_nuclei_server.git
|
|
35
|
+
cd mcp_nuclei_server
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
2. Install UV and activate environment:
|
|
39
|
+
```bash
|
|
40
|
+
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
|
|
41
|
+
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
3. Install dependencies:
|
|
45
|
+
```bash
|
|
46
|
+
# Create and activate virtual environment
|
|
47
|
+
uv venv
|
|
48
|
+
source .venv/bin/activate
|
|
49
|
+
# Install mcp related packages
|
|
50
|
+
uv pip install mcp
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Usage Guide
|
|
54
|
+
|
|
55
|
+
### MCP Configuration (Example for CLINE)
|
|
56
|
+
|
|
57
|
+
1. Reference MCP JSON configuration:
|
|
58
|
+
```json
|
|
59
|
+
{
|
|
60
|
+
"mcpServers": {
|
|
61
|
+
"nuclei_mcp_server": {
|
|
62
|
+
"command": "/path/to/uv", # path to uv
|
|
63
|
+
"args": [
|
|
64
|
+
"--directory",
|
|
65
|
+
"/path/to/nuclei_mcp_server/",
|
|
66
|
+
"run",
|
|
67
|
+
"main.py"
|
|
68
|
+
],
|
|
69
|
+
"env": {
|
|
70
|
+
"NUCLEI_BIN_PATH": "/path/to/nuclei"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Usage Example
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
### Parameter Description
|
|
81
|
+
|
|
82
|
+
- `target`: Target URL or IP address
|
|
83
|
+
- `templates`: List of specific templates to use (optional)
|
|
84
|
+
- `severity`: Vulnerability severity filter (critical, high, medium, low, info)
|
|
85
|
+
- `template_tags`: Template tag filter (optional)
|
|
86
|
+
- `output_format`: Output format (default: "json")
|
|
87
|
+
|
|
88
|
+
## Output Format
|
|
89
|
+
|
|
90
|
+
Scan results are returned in JSON format with the following fields:
|
|
91
|
+
|
|
92
|
+
```json
|
|
93
|
+
{
|
|
94
|
+
"success": true,
|
|
95
|
+
"target": "https://example.com",
|
|
96
|
+
"time_cost_seconds": 10.5,
|
|
97
|
+
"results": [
|
|
98
|
+
{
|
|
99
|
+
"template": "template-name",
|
|
100
|
+
"severity": "high",
|
|
101
|
+
"matched_at": "https://example.com/path",
|
|
102
|
+
"info": {
|
|
103
|
+
"name": "Vulnerability Name",
|
|
104
|
+
"description": "Vulnerability Description"
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
]
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Contributing
|
|
112
|
+
|
|
113
|
+
Issues and Pull Requests are welcome!
|
|
114
|
+
|
|
115
|
+
1. Fork the project
|
|
116
|
+
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
117
|
+
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
118
|
+
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
119
|
+
5. Open a Pull Request
|
|
120
|
+
|
|
121
|
+
## License
|
|
122
|
+
|
|
123
|
+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
|
|
124
|
+
|
|
125
|
+
## Contact
|
|
126
|
+
|
|
127
|
+
For any questions or suggestions, please contact us through:
|
|
128
|
+
- Submit an Issue
|
README.zh-cn.md
ADDED
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# MCP Nuclei 服务器
|
|
2
|
+
|
|
3
|
+
[](https://www.python.org/downloads/)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://github.com/crazyMarky/mcp_nuclei_server)
|
|
6
|
+
[](README.md)
|
|
7
|
+
|
|
8
|
+
一个基于 MCP (Model Control Protocol) 的 Nuclei 安全扫描服务器，提供便捷的漏洞扫描服务。
|
|
9
|
+
|
|
10
|
+
## 项目介绍
|
|
11
|
+
|
|
12
|
+
MCP Nuclei Server 是一个基于 MCP 协议开发的 Nuclei 安全扫描服务。它允许大模型来执行 Nuclei 安全扫描，支持多种扫描选项和结果输出格式。
|
|
13
|
+
|
|
14
|
+
主要特性：
|
|
15
|
+
- 支持 Nuclei 安全扫描
|
|
16
|
+
- 可配置的模板和标签过滤
|
|
17
|
+
- 支持按严重程度筛选漏洞
|
|
18
|
+
- JSON 格式输出结果
|
|
19
|
+
- 易于集成的 MCP 服务
|
|
20
|
+
|
|
21
|
+
## 安装说明
|
|
22
|
+
|
|
23
|
+
### 前提条件
|
|
24
|
+
|
|
25
|
+
- Python 3.8 或更高版本
|
|
26
|
+
- Nuclei 二进制文件（已安装并配置）
|
|
27
|
+
|
|
28
|
+
### 安装步骤
|
|
29
|
+
|
|
30
|
+
1. 克隆仓库：
|
|
31
|
+
```bash
|
|
32
|
+
git clone https://github.com/crazyMarky/mcp_nuclei_server.git
|
|
33
|
+
cd mcp_nuclei_server
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
2. 安装UV并激活环境：
|
|
37
|
+
```bash
|
|
38
|
+
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
|
|
39
|
+
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
3. 安装依赖：
|
|
43
|
+
```bash
|
|
44
|
+
# 创建虚拟环境并激活它
|
|
45
|
+
uv venv
|
|
46
|
+
source .venv/bin/activate
|
|
47
|
+
# 安装mcp相关的包
|
|
48
|
+
uv pip install mcp
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 使用方法
|
|
52
|
+
|
|
53
|
+
### 配置MCP（举例CLINE）
|
|
54
|
+
|
|
55
|
+
1、参考mcp的json配置：
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"mcpServers": {
|
|
59
|
+
"nuclei_mcp_server": {
|
|
60
|
+
"command": "/path/to/uv", #uv的路径
|
|
61
|
+
"args": [
|
|
62
|
+
"--directory",
|
|
63
|
+
"/path/to/nuclei_mcp_server/",
|
|
64
|
+
"run",
|
|
65
|
+
"main.py"
|
|
66
|
+
],
|
|
67
|
+
"env": {
|
|
68
|
+
"NUCLEI_BIN_PATH": "/path/to/nuclei"
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
### 调用示例
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
### 参数说明
|
|
78
|
+
|
|
79
|
+
- `target`: 目标 URL 或 IP 地址
|
|
80
|
+
- `templates`: 要使用的特定模板列表（可选）
|
|
81
|
+
- `severity`: 漏洞严重程度过滤（critical, high, medium, low, info）
|
|
82
|
+
- `template_tags`: 模板标签过滤（可选）
|
|
83
|
+
- `output_format`: 输出格式（默认为 "json"）
|
|
84
|
+
|
|
85
|
+
## 输出格式
|
|
86
|
+
|
|
87
|
+
扫描结果以 JSON 格式返回，包含以下字段：
|
|
88
|
+
|
|
89
|
+
```json
|
|
90
|
+
{
|
|
91
|
+
"success": true,
|
|
92
|
+
"target": "https://example.com",
|
|
93
|
+
"time_cost_seconds": 10.5,
|
|
94
|
+
"results": [
|
|
95
|
+
{
|
|
96
|
+
"template": "template-name",
|
|
97
|
+
"severity": "high",
|
|
98
|
+
"matched_at": "https://example.com/path",
|
|
99
|
+
"info": {
|
|
100
|
+
"name": "Vulnerability Name",
|
|
101
|
+
"description": "Vulnerability Description"
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
]
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## 贡献指南
|
|
109
|
+
|
|
110
|
+
欢迎提交 Issue 和 Pull Request！
|
|
111
|
+
|
|
112
|
+
1. Fork 项目
|
|
113
|
+
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
|
|
114
|
+
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
|
115
|
+
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
|
116
|
+
5. 开启 Pull Request
|
|
117
|
+
|
|
118
|
+
## 许可证
|
|
119
|
+
|
|
120
|
+
本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件
|
|
121
|
+
|
|
122
|
+
## 联系方式
|
|
123
|
+
|
|
124
|
+
如有任何问题或建议，请通过以下方式联系我们：
|
|
125
|
+
- 提交 Issue
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: iflow-mcp_crazymarky-mcp_nuclei_server
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A Nuclei security scanning server based on MCP
|
|
5
|
+
Author: crazyMarky
|
|
6
|
+
License: MIT
|
|
7
|
+
Requires-Python: >=3.8
|
|
8
|
+
Requires-Dist: mcp>=0.9.0
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
|
|
11
|
+
[](https://mseep.ai/app/crazymarky-mcp-nuclei-server)
|
|
12
|
+
|
|
13
|
+
# MCP Nuclei Server
|
|
14
|
+
|
|
15
|
+
[](https://www.python.org/downloads/)
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](https://github.com/crazyMarky/mcp_nuclei_server)
|
|
18
|
+
[](README.zh-cn.md)
|
|
19
|
+
|
|
20
|
+
A Nuclei security scanning server based on MCP (Model Control Protocol), providing convenient vulnerability scanning services.
|
|
21
|
+
|
|
22
|
+
## Project Introduction
|
|
23
|
+
|
|
24
|
+
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.
|
|
25
|
+
|
|
26
|
+
Key Features:
|
|
27
|
+
- Support for Nuclei security scanning
|
|
28
|
+
- Configurable template and tag filtering
|
|
29
|
+
- Support for severity-based vulnerability filtering
|
|
30
|
+
- JSON format output results
|
|
31
|
+
- Easy-to-integrate MCP service
|
|
32
|
+
|
|
33
|
+
## Installation Guide
|
|
34
|
+
|
|
35
|
+
### Prerequisites
|
|
36
|
+
|
|
37
|
+
- Python 3.8 or higher
|
|
38
|
+
- Nuclei binary (installed and configured)
|
|
39
|
+
|
|
40
|
+
### Installation Steps
|
|
41
|
+
|
|
42
|
+
1. Clone the repository:
|
|
43
|
+
```bash
|
|
44
|
+
git clone https://github.com/crazyMarky/mcp_nuclei_server.git
|
|
45
|
+
cd mcp_nuclei_server
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
2. Install UV and activate environment:
|
|
49
|
+
```bash
|
|
50
|
+
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
|
|
51
|
+
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
3. Install dependencies:
|
|
55
|
+
```bash
|
|
56
|
+
# Create and activate virtual environment
|
|
57
|
+
uv venv
|
|
58
|
+
source .venv/bin/activate
|
|
59
|
+
# Install mcp related packages
|
|
60
|
+
uv pip install mcp
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Usage Guide
|
|
64
|
+
|
|
65
|
+
### MCP Configuration (Example for CLINE)
|
|
66
|
+
|
|
67
|
+
1. Reference MCP JSON configuration:
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"mcpServers": {
|
|
71
|
+
"nuclei_mcp_server": {
|
|
72
|
+
"command": "/path/to/uv", # path to uv
|
|
73
|
+
"args": [
|
|
74
|
+
"--directory",
|
|
75
|
+
"/path/to/nuclei_mcp_server/",
|
|
76
|
+
"run",
|
|
77
|
+
"main.py"
|
|
78
|
+
],
|
|
79
|
+
"env": {
|
|
80
|
+
"NUCLEI_BIN_PATH": "/path/to/nuclei"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Usage Example
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
### Parameter Description
|
|
91
|
+
|
|
92
|
+
- `target`: Target URL or IP address
|
|
93
|
+
- `templates`: List of specific templates to use (optional)
|
|
94
|
+
- `severity`: Vulnerability severity filter (critical, high, medium, low, info)
|
|
95
|
+
- `template_tags`: Template tag filter (optional)
|
|
96
|
+
- `output_format`: Output format (default: "json")
|
|
97
|
+
|
|
98
|
+
## Output Format
|
|
99
|
+
|
|
100
|
+
Scan results are returned in JSON format with the following fields:
|
|
101
|
+
|
|
102
|
+
```json
|
|
103
|
+
{
|
|
104
|
+
"success": true,
|
|
105
|
+
"target": "https://example.com",
|
|
106
|
+
"time_cost_seconds": 10.5,
|
|
107
|
+
"results": [
|
|
108
|
+
{
|
|
109
|
+
"template": "template-name",
|
|
110
|
+
"severity": "high",
|
|
111
|
+
"matched_at": "https://example.com/path",
|
|
112
|
+
"info": {
|
|
113
|
+
"name": "Vulnerability Name",
|
|
114
|
+
"description": "Vulnerability Description"
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
]
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## Contributing
|
|
122
|
+
|
|
123
|
+
Issues and Pull Requests are welcome!
|
|
124
|
+
|
|
125
|
+
1. Fork the project
|
|
126
|
+
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
127
|
+
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
128
|
+
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
129
|
+
5. Open a Pull Request
|
|
130
|
+
|
|
131
|
+
## License
|
|
132
|
+
|
|
133
|
+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
|
|
134
|
+
|
|
135
|
+
## Contact
|
|
136
|
+
|
|
137
|
+
For any questions or suggestions, please contact us through:
|
|
138
|
+
- Submit an Issue
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
./.gitignore,sha256=gTXWNkU-lBPIbWYcPr5y0CEL--xbNjejJatiSTvW638,108
|
|
2
|
+
./3170_process.log,sha256=6dSrzalzbQ6yVNaDfcCEMRH--0ppVv76h_FkMsAFVuY,469
|
|
3
|
+
./PKG-INFO,sha256=QxTqE7EFSUUHXbUhzJ6S8vQ1Pjdbj8G9ZejI81oDZHc,3858
|
|
4
|
+
./README.md,sha256=Yu-mvjxedRQim_AqUVIUbsN3wHomlchFCXVuuc_IROI,3598
|
|
5
|
+
./README.zh-cn.md,sha256=syMZhbwduHxRR3t5RAFLCIk2GVc0v2NMx79AB9l2Es0,3228
|
|
6
|
+
./language.json,sha256=EaSmC1GL8kmJ1IFGgHbl1ZgohGJq7Z-us1uFdvzSI-E,6
|
|
7
|
+
./main.py,sha256=49oT6gVC-4JgRFbKf-nOFMAVBlzSHlLfbemLHGFh8eU,4665
|
|
8
|
+
./package_name,sha256=6M92WtaIX5IYymxupqOFtXtvncweTO49gSduJsWcEUY,38
|
|
9
|
+
./push_info.json,sha256=uwai9RHChZ3Q8qPSrxGNB350KJI1XkJdjSsp3T1F-Ms,132
|
|
10
|
+
./pyproject.toml,sha256=hsU6nMrLeOdc1FYRD3suqvEZqxYWjei1bCAojRTvoEE,506
|
|
11
|
+
./DOCS/示例.jpeg,sha256=MqifRKBbJgpo5YbAEzrFd0sf0DaWzK4k8bB7iegC4WA,359873
|
|
12
|
+
iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/METADATA,sha256=QxTqE7EFSUUHXbUhzJ6S8vQ1Pjdbj8G9ZejI81oDZHc,3858
|
|
13
|
+
iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
14
|
+
iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/entry_points.txt,sha256=mh4Y3jfFS0J8FBGTWeM0CXeiCsCwDMcGcrlrlpWabqM,44
|
|
15
|
+
iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0.dist-info/RECORD,,
|
language.json
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
python
|
main.py
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import logging
|
|
2
|
+
import os
|
|
3
|
+
import random
|
|
4
|
+
import subprocess
|
|
5
|
+
import json
|
|
6
|
+
import sys
|
|
7
|
+
import time
|
|
8
|
+
from typing import List, Optional
|
|
9
|
+
|
|
10
|
+
from mcp.server.fastmcp import FastMCP
|
|
11
|
+
|
|
12
|
+
logger = logging.getLogger('mcp_nuclei_server')
|
|
13
|
+
|
|
14
|
+
# Create server
|
|
15
|
+
mcp = FastMCP("mcp_nuclei_server")
|
|
16
|
+
|
|
17
|
+
# reconfigure UnicodeEncodeError prone default (i.e. windows-1252) to utf-8
|
|
18
|
+
if sys.platform == "win32" and os.environ.get('PYTHONIOENCODING') is None:
|
|
19
|
+
sys.stdin.reconfigure(encoding="utf-8")
|
|
20
|
+
sys.stdout.reconfigure(encoding="utf-8")
|
|
21
|
+
sys.stderr.reconfigure(encoding="utf-8")
|
|
22
|
+
|
|
23
|
+
nuclei_bin_path = os.environ.get("NUCLEI_BIN_PATH")
|
|
24
|
+
if not nuclei_bin_path:
|
|
25
|
+
logger.debug("NUCLEI_BIN_PATH is not set！")
|
|
26
|
+
nuclei_bin_path = 'nuclei'
|
|
27
|
+
else:
|
|
28
|
+
logger.info(f"nuclei_bin_path was loaded:{nuclei_bin_path}")
|
|
29
|
+
|
|
30
|
+
@mcp.tool()
|
|
31
|
+
def nuclei_scan_start(
|
|
32
|
+
target: str,
|
|
33
|
+
templates: Optional[List[str]] = None,
|
|
34
|
+
severity: Optional[str] = None,
|
|
35
|
+
template_tags: Optional[List[str]] = None,
|
|
36
|
+
output_format: str = "json",
|
|
37
|
+
) -> str:
|
|
38
|
+
"""a mcp server for Nuclei security scan."""
|
|
39
|
+
return run_nuclei(target, templates, severity,template_tags, output_format)
|
|
40
|
+
|
|
41
|
+
def run_nuclei(
|
|
42
|
+
target: str,
|
|
43
|
+
templates: Optional[List[str]] = None,
|
|
44
|
+
severity: Optional[str] = None,
|
|
45
|
+
template_tags: Optional[List[str]] = None,
|
|
46
|
+
output_format: str = "json",
|
|
47
|
+
) -> str:
|
|
48
|
+
"""Run a Nuclei security scan on the specified target.
|
|
49
|
+
|
|
50
|
+
Args:
|
|
51
|
+
target: The target URL or IP to scan
|
|
52
|
+
templates: List of specific template names to use (optional)
|
|
53
|
+
template_tags: List of specific template tags names to use (optional)
|
|
54
|
+
severity: Filter by severity level (critical, high, medium, low, info)
|
|
55
|
+
output_format: Output format (json, text)
|
|
56
|
+
|
|
57
|
+
Returns:
|
|
58
|
+
str: JSON string containing scan results
|
|
59
|
+
"""
|
|
60
|
+
try:
|
|
61
|
+
# Check if nuclei binary exists
|
|
62
|
+
if nuclei_bin_path == 'nuclei':
|
|
63
|
+
# Check if nuclei is in PATH
|
|
64
|
+
try:
|
|
65
|
+
subprocess.run([nuclei_bin_path, "-version"], capture_output=True, check=True)
|
|
66
|
+
except (subprocess.CalledProcessError, FileNotFoundError):
|
|
67
|
+
# Nuclei not available, return mock result for testing
|
|
68
|
+
logger.warning(f"Nuclei binary not found, returning mock result for testing")
|
|
69
|
+
return json.dumps({
|
|
70
|
+
"success": True,
|
|
71
|
+
"target": target,
|
|
72
|
+
"time_cost_seconds": 0.0,
|
|
73
|
+
"results": [],
|
|
74
|
+
"note": "Nuclei binary not available - this is a mock result for testing"
|
|
75
|
+
})
|
|
76
|
+
|
|
77
|
+
# Build the command
|
|
78
|
+
cmd = [nuclei_bin_path, "-u", target, "-j","-duc"]
|
|
79
|
+
|
|
80
|
+
# Add template filters if specified
|
|
81
|
+
if templates:
|
|
82
|
+
cmd.extend(["-t", ",".join(templates)])
|
|
83
|
+
|
|
84
|
+
if template_tags:
|
|
85
|
+
cmd.extend(["-tags", ",".join(template_tags)])
|
|
86
|
+
|
|
87
|
+
# Add severity filter if specified
|
|
88
|
+
if severity:
|
|
89
|
+
cmd.extend(["-s", severity])
|
|
90
|
+
start_time = time.time()
|
|
91
|
+
# Run the scan
|
|
92
|
+
result = subprocess.run(
|
|
93
|
+
cmd,
|
|
94
|
+
capture_output=True,
|
|
95
|
+
text=True,
|
|
96
|
+
check=True
|
|
97
|
+
)
|
|
98
|
+
|
|
99
|
+
# Parse the output
|
|
100
|
+
try:
|
|
101
|
+
# 逐行解析 JSON 输出
|
|
102
|
+
vulnerabilities = []
|
|
103
|
+
for line in result.stdout.splitlines():
|
|
104
|
+
try:
|
|
105
|
+
if line.strip():
|
|
106
|
+
vulnerability = json.loads(line)
|
|
107
|
+
vulnerabilities.append(vulnerability)
|
|
108
|
+
except json.JSONDecodeError as e:
|
|
109
|
+
print(f"Failed to parse JSON: {e}")
|
|
110
|
+
return json.dumps({
|
|
111
|
+
"success": True,
|
|
112
|
+
"target": target,
|
|
113
|
+
"time_cost_seconds": time.time() - start_time,
|
|
114
|
+
"results": vulnerabilities
|
|
115
|
+
})
|
|
116
|
+
except json.JSONDecodeError:
|
|
117
|
+
return json.dumps({
|
|
118
|
+
"success": False,
|
|
119
|
+
"error": "Failed to parse JSON output",
|
|
120
|
+
"raw_output": result.stdout,
|
|
121
|
+
"stderr": result.stderr
|
|
122
|
+
})
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
except subprocess.CalledProcessError as e:
|
|
126
|
+
return json.dumps({
|
|
127
|
+
"success": False,
|
|
128
|
+
"error": str(e),
|
|
129
|
+
"stderr": e.stderr
|
|
130
|
+
})
|
|
131
|
+
except Exception as e:
|
|
132
|
+
return json.dumps({
|
|
133
|
+
"success": False,
|
|
134
|
+
"error": str(e)
|
|
135
|
+
})
|
|
136
|
+
|
|
137
|
+
def main():
|
|
138
|
+
"""Main entry point for the MCP server."""
|
|
139
|
+
logger.info("Starting nuclei MCP server...")
|
|
140
|
+
# init and run
|
|
141
|
+
mcp.run(transport='stdio')
|
|
142
|
+
|
|
143
|
+
if __name__ == "__main__":
|
|
144
|
+
main()
|
package_name
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
iflow-mcp_crazymarky-mcp_nuclei_server
|
push_info.json
ADDED
pyproject.toml
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "iflow-mcp_crazymarky-mcp_nuclei_server"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "A Nuclei security scanning server based on MCP"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.8"
|
|
7
|
+
license = {text = "MIT"}
|
|
8
|
+
authors = [
|
|
9
|
+
{name = "crazyMarky"}
|
|
10
|
+
]
|
|
11
|
+
dependencies = [
|
|
12
|
+
"mcp>=0.9.0",
|
|
13
|
+
]
|
|
14
|
+
|
|
15
|
+
[project.scripts]
|
|
16
|
+
nuclei-server = "main:main"
|
|
17
|
+
|
|
18
|
+
[build-system]
|
|
19
|
+
requires = ["hatchling"]
|
|
20
|
+
build-backend = "hatchling.build"
|
|
21
|
+
|
|
22
|
+
[tool.hatch.build.targets.wheel]
|
|
23
|
+
packages = ["."]
|
|
24
|
+
include = [
|
|
25
|
+
"main.py",
|
|
26
|
+
"README.md",
|
|
27
|
+
]
|