iflow-mcp_crazymarky-mcp_nuclei_server 0.1.0__tar.gz

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+.nuclei-config/nuclei/.templates-config.json
+.nuclei-config/nuclei/reporting-config.yaml
+nuclei/config.yaml

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/3170_process.log

@@ -0,0 +1,6 @@
+[2025-02-05] [SUCCESS] 步骤1 - 获取项目: Fork并克隆成功
+github_url: crazyMarky/mcp_nuclei_server
+fork_github_url: https://github.com/iflow-mcp/crazymarky-mcp_nuclei_server
+name: crazymarky-mcp_nuclei_server[2025-02-05] [SUCCESS] 步骤2 - 阅读代码: 项目分析完成，Python语言，MCP服务端项目
+[2025-02-05] [SUCCESS] 步骤3 - 本地测试: 测试通过，发现1个工具
+[2025-02-05] [SUCCESS] 步骤4 - 推送分支: iflow分支推送成功

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_crazymarky-mcp_nuclei_server
+Version: 0.1.0
+Summary: A Nuclei security scanning server based on MCP
+Author: crazyMarky
+License: MIT
+Requires-Python: >=3.8
+Requires-Dist: mcp>=0.9.0
+Description-Content-Type: text/markdown
+
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/crazymarky-mcp-nuclei-server-badge.png)](https://mseep.ai/app/crazymarky-mcp-nuclei-server)
+
+# MCP Nuclei Server
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/yourusername/mcp_nuclei_server.svg?style=social)](https://github.com/crazyMarky/mcp_nuclei_server)
+[![中文文档](https://img.shields.io/badge/中文文档-README.zh--cn.md-blue)](README.zh-cn.md)
+
+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
+
+1. Clone the repository:
+```bash
+git clone https://github.com/crazyMarky/mcp_nuclei_server.git
+cd mcp_nuclei_server
+```
+
+2. Install UV and activate environment:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
+```
+
+3. Install dependencies:
+```bash
+# 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)
+
+1. Reference MCP JSON configuration:
+```json
+{
+  "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
+![Example](./DOCS/示例.jpeg "CLINE usage example")
+
+### Parameter Description
+
+- `target`: Target URL or IP address
+- `templates`: 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:
+
+```json
+{
+    "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!
+
+1. Fork the project
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
+
+## Contact
+
+For any questions or suggestions, please contact us through:
+- Submit an Issue 

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/README.md

@@ -0,0 +1,128 @@
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/crazymarky-mcp-nuclei-server-badge.png)](https://mseep.ai/app/crazymarky-mcp-nuclei-server)
+
+# MCP Nuclei Server
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/yourusername/mcp_nuclei_server.svg?style=social)](https://github.com/crazyMarky/mcp_nuclei_server)
+[![中文文档](https://img.shields.io/badge/中文文档-README.zh--cn.md-blue)](README.zh-cn.md)
+
+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
+
+1. Clone the repository:
+```bash
+git clone https://github.com/crazyMarky/mcp_nuclei_server.git
+cd mcp_nuclei_server
+```
+
+2. Install UV and activate environment:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
+```
+
+3. Install dependencies:
+```bash
+# 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)
+
+1. Reference MCP JSON configuration:
+```json
+{
+  "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
+![Example](./DOCS/示例.jpeg "CLINE usage example")
+
+### Parameter Description
+
+- `target`: Target URL or IP address
+- `templates`: 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:
+
+```json
+{
+    "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!
+
+1. Fork the project
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
+
+## Contact
+
+For any questions or suggestions, please contact us through:
+- Submit an Issue 

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/README.zh-cn.md

@@ -0,0 +1,125 @@
+# MCP Nuclei 服务器
+
+[![Python 版本](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![许可证](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/yourusername/mcp_nuclei_server.svg?style=social)](https://github.com/crazyMarky/mcp_nuclei_server)
+[![English Documentation](https://img.shields.io/badge/English-README.md-blue)](README.md)
+
+一个基于 MCP (Model Control Protocol) 的 Nuclei 安全扫描服务器，提供便捷的漏洞扫描服务。
+
+## 项目介绍
+
+MCP Nuclei Server 是一个基于 MCP 协议开发的 Nuclei 安全扫描服务。它允许大模型来执行 Nuclei 安全扫描，支持多种扫描选项和结果输出格式。
+
+主要特性：
+- 支持 Nuclei 安全扫描
+- 可配置的模板和标签过滤
+- 支持按严重程度筛选漏洞
+- JSON 格式输出结果
+- 易于集成的 MCP 服务
+
+## 安装说明
+
+### 前提条件
+
+- Python 3.8 或更高版本
+- Nuclei 二进制文件（已安装并配置）
+
+### 安装步骤
+
+1. 克隆仓库：
+```bash
+git clone https://github.com/crazyMarky/mcp_nuclei_server.git
+cd mcp_nuclei_server
+```
+
+2. 安装UV并激活环境：
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh # Linux/Mac
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
+```
+
+3. 安装依赖：
+```bash
+# 创建虚拟环境并激活它
+uv venv
+source .venv/bin/activate
+# 安装mcp相关的包
+uv pip install mcp
+```
+ 
+## 使用方法
+
+### 配置MCP（举例CLINE）
+
+1、参考mcp的json配置：
+```json
+{
+  "mcpServers": {
+    "nuclei_mcp_server": {
+      "command": "/path/to/uv", #uv的路径
+      "args": [
+        "--directory",
+        "/path/to/nuclei_mcp_server/",
+        "run",
+        "main.py"
+      ],
+      "env": {
+        "NUCLEI_BIN_PATH": "/path/to/nuclei"
+      }
+    }
+  }
+}
+```
+### 调用示例
+![示例](./DOCS/示例.jpeg "cline使用示例")
+
+### 参数说明
+
+- `target`: 目标 URL 或 IP 地址
+- `templates`: 要使用的特定模板列表（可选）
+- `severity`: 漏洞严重程度过滤（critical, high, medium, low, info）
+- `template_tags`: 模板标签过滤（可选）
+- `output_format`: 输出格式（默认为 "json"）
+
+## 输出格式
+
+扫描结果以 JSON 格式返回，包含以下字段：
+
+```json
+{
+    "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"
+            }
+        }
+    ]
+}
+```
+
+## 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+## 许可证
+
+本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件
+
+## 联系方式
+
+如有任何问题或建议，请通过以下方式联系我们：
+- 提交 Issue

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/language.json

@@ -0,0 +1 @@
+python

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/main.py

@@ -0,0 +1,144 @@
+import logging
+import os
+import random
+import subprocess
+import json
+import sys
+import time
+from typing import List, Optional
+
+from mcp.server.fastmcp import FastMCP
+
+logger = logging.getLogger('mcp_nuclei_server')
+
+# Create server
+mcp = FastMCP("mcp_nuclei_server")
+
+# reconfigure UnicodeEncodeError prone default (i.e. windows-1252) to utf-8
+if sys.platform == "win32" and os.environ.get('PYTHONIOENCODING') is None:
+    sys.stdin.reconfigure(encoding="utf-8")
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+
+nuclei_bin_path = os.environ.get("NUCLEI_BIN_PATH")
+if not nuclei_bin_path:
+    logger.debug("NUCLEI_BIN_PATH is not set！")
+    nuclei_bin_path = 'nuclei'
+else:
+    logger.info(f"nuclei_bin_path was loaded:{nuclei_bin_path}")
+
+@mcp.tool()
+def nuclei_scan_start(
+    target: str,
+    templates: Optional[List[str]] = None,
+    severity: Optional[str] = None,
+    template_tags: Optional[List[str]] = None,
+    output_format: str = "json",
+) -> str:
+    """a mcp server for Nuclei security scan."""
+    return run_nuclei(target, templates, severity,template_tags, output_format)
+
+def run_nuclei(
+    target: str,
+    templates: Optional[List[str]] = None,
+    severity: Optional[str] = None,
+    template_tags: Optional[List[str]] = None,
+    output_format: str = "json",
+) -> str:
+    """Run a Nuclei security scan on the specified target.
+    
+    Args:
+        target: The target URL or IP to scan
+        templates: List of specific template names to use (optional)
+        template_tags: List of specific template tags names to use (optional)
+        severity: Filter by severity level (critical, high, medium, low, info)
+        output_format: Output format (json, text)
+    
+    Returns:
+        str: JSON string containing scan results
+    """
+    try:
+        # Check if nuclei binary exists
+        if nuclei_bin_path == 'nuclei':
+            # Check if nuclei is in PATH
+            try:
+                subprocess.run([nuclei_bin_path, "-version"], capture_output=True, check=True)
+            except (subprocess.CalledProcessError, FileNotFoundError):
+                # Nuclei not available, return mock result for testing
+                logger.warning(f"Nuclei binary not found, returning mock result for testing")
+                return json.dumps({
+                    "success": True,
+                    "target": target,
+                    "time_cost_seconds": 0.0,
+                    "results": [],
+                    "note": "Nuclei binary not available - this is a mock result for testing"
+                })
+        
+        # Build the command
+        cmd = [nuclei_bin_path, "-u", target, "-j","-duc"]
+        
+        # Add template filters if specified
+        if templates:
+            cmd.extend(["-t", ",".join(templates)])
+        
+        if template_tags:
+            cmd.extend(["-tags", ",".join(template_tags)])
+        
+        # Add severity filter if specified
+        if severity:
+            cmd.extend(["-s", severity])
+        start_time = time.time()
+        # Run the scan
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        
+        # Parse the output
+        try:
+            # 逐行解析 JSON 输出
+            vulnerabilities = []
+            for line in result.stdout.splitlines():
+                try:
+                    if line.strip():
+                        vulnerability = json.loads(line)
+                        vulnerabilities.append(vulnerability)
+                except json.JSONDecodeError as e:
+                    print(f"Failed to parse JSON: {e}")
+            return json.dumps({
+                "success": True,
+                "target": target,
+                "time_cost_seconds": time.time() - start_time,
+                "results": vulnerabilities
+            })
+        except json.JSONDecodeError:
+            return json.dumps({
+                "success": False,
+                "error": "Failed to parse JSON output",
+                "raw_output": result.stdout,
+                "stderr": result.stderr
+            })
+        
+        
+    except subprocess.CalledProcessError as e:
+        return json.dumps({
+            "success": False,
+            "error": str(e),
+            "stderr": e.stderr
+        })
+    except Exception as e:
+        return json.dumps({
+            "success": False,
+            "error": str(e)
+        })
+
+def main():
+    """Main entry point for the MCP server."""
+    logger.info("Starting nuclei MCP server...")
+    # init and run
+    mcp.run(transport='stdio')
+
+if __name__ == "__main__":
+    main()

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/package_name

@@ -0,0 +1 @@
+iflow-mcp_crazymarky-mcp_nuclei_server

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/push_info.json

@@ -0,0 +1,5 @@
+{
+  "push_platform": "github",
+  "fork_url": "https://github.com/iflow-mcp/crazymarky-mcp_nuclei_server",
+  "fork_branch": "iflow"
+}

iflow_mcp_crazymarky_mcp_nuclei_server-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "iflow-mcp_crazymarky-mcp_nuclei_server"
+version = "0.1.0"
+description = "A Nuclei security scanning server based on MCP"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "crazyMarky"}
+]
+dependencies = [
+    "mcp>=0.9.0",
+]
+
+[project.scripts]
+nuclei-server = "main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+include = [
+    "main.py",
+    "README.md",
+]