fscan_mcp

fscan_mcp

3
security

fscan MCP is a service that integrates port scanning and vulnerability detection using the fscan tool. It leverages the FastMCP framework to provide standardized interfaces for easy integration, supporting various customizable scanning parameters and output options.

fscan MCP 项目指南

项目概述

fscan MCP 是一个基于 fscan 工具的端口扫描和漏洞检测的 MCP 服务封装。项目通过 FastMCP 框架提供标准化的接口，便于集成到其他系统中。

项目结构

├── brute-passwd/       # 爆破字典目录
├── .trae/              # 项目规则配置
├── config.py           # 配置文件
├── fscan.exe           # fscan 可执行文件
├── fscan_mcp_server.py # 主服务文件
├── logger.py           # 日志模块
├── pyproject.toml      # 项目配置文件
└── README.md           # 项目说明文档

使用流程

  1. 初始化环境

    • 确保系统已安装 Python 3.12+ 环境
    • 安装项目依赖：pip install -r requirements.txt

  2. 启动服务

    • 运行主服务：uv --directory /path/to/fscan_mcp --with mcp mcp run fscan_mcp_server.py

  3. 调用服务

    • 通过 MCP 协议调用 fscan_mcp_server 工具
    • 支持参数：
      • ip (str): 目标 IP 地址，必填参数
      • port_range (str): 端口范围，默认 1-65535
      • proxy (str): 代理地址，可选
      • output_path (str): 输出文件路径，可选
      • input_file (str): 输入文件路径，可选
      • report (bool): 是否生成报告，默认 False
      • vuln_scan (bool): 是否进行漏洞扫描，默认 False

  4. 结果处理

    • 扫描结果通过 stdout 返回
    • 报告文件保存在指定路径

关键模块

  • fscan_mcp_server.py: 主服务模块，封装 fscan 工具的 MCP 接口
  • config.py: 配置文件，包含扫描参数和漏洞检测配置
  • logger.py: 日志模块，记录服务运行状态

注意事项

  • 确保 fscan.exe 文件存在于项目根目录
  • 扫描前请确认目标系统是否允许进行端口扫描

提示词:

// 提示词部分:用户可设定在server内部也可设定在客户端，为了更好的体验建议设定在server内部,避免调用时出现问题,默认未添加

语言设定

使用中文进行交互与输出。

触发机制与操作流程（调用fscan_mcp）

当系统接收到用户输入的 IP 地址时，需立即调用 fscan_mcp 工具对该 IP 地址进行全面扫描。扫描任务完成后，按照以下逻辑进行后续操作：

报告生成要求（调用工具阶段）

所有生成的结果都存放在/fscan_result目录下 2.可视化内容：依据(逻辑处理)的结果进行生成,使用工具生成标准化、格式化的端口检测报告.html文件 3.将所有web资产进行收集保存为result_url.txt(基础写入至txt)