NebulaFinger MCP

Una interfaz de servidor MCP para la herramienta de reconocimiento de huellas digitales NebulaFinger.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Guía de configuración de NebulaFinger MCP

Nota sobre la relación del proyecto: Este módulo MCP es la implementación de la interfaz de agente de IA para la herramienta de reconocimiento de huellas NebulaFinger. La implementación MCP independiente completa se puede encontrar en MCP-NebulaFinger. Esta interfaz permite que los modelos de lenguaje grandes llamen directamente a NebulaFinger para el reconocimiento de huellas de servicios web.

📋 Requisitos previos

  1. Python 3.8+ instalado
  2. NebulaFinger.exe compilado o descargado
  3. FastMCP biblioteca instalada

Nota sobre compatibilidad multiplataforma: Aunque la documentación hace referencia a NebulaFinger.exe (ejecutable de Windows), la herramienta NebulaFinger se puede compilar según el sistema operativo de su entorno. En sistemas Linux/macOS, puede compilar desde el código fuente para generar un ejecutable sin extensión.

🛠️ Pasos de instalación

1. Instalar dependencias

pip install fastmcp

2. Estructura del proyecto

Asegúrese de que la estructura de su proyecto sea la siguiente:

NebulaFinger/
├── NebulaFinger.exe           # 主程序
├── configs/                   # 配置目录
│   ├── web_fingerprint_v4.json
│   ├── service_fingerprint_v4.json
│   ├── fingerprint_weights.json
│   └── tcp_ports.json
├── MCP/                       # MCP 服务目录
│   └── mcp_server.py          # MCP 服务端脚本
└── README.md

3. Configurar el cliente MCP

Agregue la siguiente configuración en el archivo de configuración de su cliente MCP (se recomienda guardar un archivo NebulaFinger por separado, configurando la ruta absoluta):

{
  "mcpServers": {
    "nebulafinger_mcp": {
      "isActive": true,
      "name": "nebulafinger_mcp",
      "type": "stdio",
      "command": "python",
      "args": [
        "D:\\NebulaFinger\\MCP\\mcp_server.py"
      ],
      "env": {
        "NEBULAFINGER_PATH": "D:\\NebulaFinger"
      }
    }
  }
}

Notas importantes:

  • Reemplace la ruta con su ruta absoluta real
  • La variable de entorno NEBULAFINGER_PATH apunta al directorio raíz de la herramienta NebulaFinger

🔧 Funciones de herramienta disponibles

El servidor MCP proporciona las siguientes funciones de herramienta:

1. scan_target - Escanear un solo objetivo

参数：
- target: 要扫描的目标 (例如: example.com 或 http://example.com)
- mode: 扫描模式 ("web", "service", "all")，默认 "web"
- concurrent: 并发数，默认 5
- output_html: 是否生成HTML报告，默认 False
- silent: 静默模式，默认 False
- no_favicon: 禁用Favicon检测，默认 False
- bp_stat: 只输出有指纹匹配的结果，默认 False

2. scan_targets_from_list - Escanear una lista de objetivos

参数：
- targets: 要扫描的目标列表 (字符串数组)
- 其他参数与 scan_target 相同

3. scan_targets_from_file - Escanear desde archivo

参数：
- file_path: 包含目标列表的文件路径
- 其他参数与 scan_target 相同

4. get_help - Obtener información de ayuda

Obtener la información de ayuda completa de la herramienta NebulaFinger

5. get_version - Obtener información de versión

Obtener la versión de la herramienta e información básica

6. check_status - Verificar estado

Verificar el estado de la herramienta y los archivos de configuración

💡 Ejemplos de uso

En el cliente MCP (usando Cherry Studio+qwen-plus como ejemplo), puede usarlo de la siguiente manera:

Reconocimiento de huella individual

（请使用 NebulaFinger） 扫描  www.baidu.com  的 web 指纹

Reconocimiento de huellas de múltiples objetivos

使用 NebulaFinger 扫描以下网站的指纹www.baidu.com、www.github.com

Leer archivo para reconocimiento de huellas

读取文件D:\学习计划进度\GO\NebulaFinger\url_small.txt，并依次进行指纹识别，并生成结果html

🐛 Solución de problemas

1. No se encuentra NebulaFinger.exe

  • Asegúrese de que la variable de entorno NEBULAFINGER_PATH esté configurada correctamente
  • O especifique la ruta correcta en los argumentos de la línea de comandos
  • Verifique que el archivo exista y tenga permisos de ejecución

2. No se encuentra el archivo de configuración

  • Asegúrese de que el directorio configs exista
  • Verifique que los archivos de la biblioteca de huellas estén completos
  • Valide que la ruta del archivo sea correcta (use rutas absolutas)

3. Problemas de codificación

  • Asegúrese de que todos los archivos usen codificación UTF-8
  • Verifique la configuración regional del sistema

4. Problemas de permisos

  • Asegúrese de que el proceso de Python tenga permisos para acceder a NebulaFinger.exe
  • Verifique los permisos de lectura y escritura de archivos y directorios

📝 Depuración de registros

El servidor generará información de registro detallada, que incluye:

  • Verificación de la ruta de la herramienta
  • Proceso de ejecución de comandos
  • Mensajes de error

Si encuentra problemas, revise la información de registro en la salida de la consola para depurar.

🔄 Actualización y mantenimiento

  1. Actualizar la biblioteca de huellas: Reemplace directamente los archivos de la biblioteca de huellas en el directorio configs
  2. Actualizar la herramienta: Reemplace el archivo NebulaFinger.exe
  3. Actualizar el servicio MCP: Modifique el archivo mcp_server.py y reinicie el cliente MCP