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)