Servidor MCP Maigret

Un servidor de Protocolo de Contexto de Modelo (MCP) para Maigret , una potente herramienta OSINT que recopila información de cuentas de usuario de diversas fuentes públicas. Este servidor proporciona herramientas para buscar nombres de usuario en redes sociales y analizar URL. Está diseñado para integrarse a la perfección con aplicaciones compatibles con MCP como Claude Desktop .

⚠️ Advertencia

Esta herramienta está diseñada para fines legítimos de investigación OSINT. Por favor:

• Busque únicamente información que esté disponible públicamente

• Respetar las leyes de privacidad y protección de datos

• Siga los términos de servicio de las plataformas que se están buscando.

• Úselo de manera responsable y ética

• Tenga en cuenta que algunos sitios pueden limitar o bloquear las búsquedas automáticas.

Related MCP server: Maigret MCP Server

Requisitos

• Node.js (v18 o posterior)

• Estibador

• macOS, Linux o Windows con Docker Desktop instalado

• Acceso de escritura al directorio de informes

Inicio rápido

Instalación mediante herrería

Para instalar Maigret para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install mcp-maigret --client claude

Instalación manual

1. Instalar Docker:

   • macOS: Instalar Docker Desktop

   • Linux: Siga la guía de instalación de Docker Engine

2. Instalar el servidor globalmente a través de npm:

npm install -g mcp-maigret

3. Crear un directorio de informes:

mkdir -p /path/to/reports/directory

4. Agregue a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "maigret": {
      "command": "mcp-maigret",
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Ubicación del archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

5. Reiniciar Claude Desktop

Configuración alternativa (de la fuente)

Si prefiere ejecutar desde la fuente o necesita modificar el código:

1. Clonar y construir:

git clone <repository_url>
cd mcp-maigret
npm install
npm run build

2. Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "maigret": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maigret/build/index.js"],
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Características

• Búsqueda de nombre de usuario : busque un nombre de usuario en cientos de redes sociales y sitios web

• Análisis de URL : analiza las URL para extraer información y buscar nombres de usuario asociados

• Múltiples formatos de salida : Compatibilidad con formatos txt, html, pdf, json, csv y xmind

• Filtrado de sitios : Filtrar búsquedas por etiquetas del sitio (por ejemplo, foto, citas, nosotros)

• Basado en Docker : ejecución confiable y consistente en todos los entornos

Herramientas

1. Herramienta de búsqueda de nombre de usuario

• Nombre: search_username

• Descripción: Busca un nombre de usuario en redes sociales y sitios.

• Parámetros:

  • username (obligatorio): Nombre de usuario a buscar

  • format (opcional, predeterminado: "pdf"): Formato de salida (txt, html, pdf, json, csv, xmind)

  • use_all_sites (opcional, predeterminado: falso): utilizar todos los sitios disponibles en lugar de los 500 principales

  • tags (opcional): Matriz de etiquetas para filtrar sitios (por ejemplo, ["foto", "citas"])

Ejemplo:

{
  "username": "test_user123",
  "format": "html",
  "use_all_sites": false,
  "tags": ["photo"]
}

2. Herramienta de análisis de URL

• Nombre: parse_url

• Descripción: Analiza una URL para extraer información y buscar nombres de usuario asociados

• Parámetros:

  • url (obligatorio): URL a analizar

  • format (opcional, predeterminado: "pdf"): Formato de salida (txt, html, pdf, json, csv, xmind)

Ejemplo:

{
  "url": "https://example.com/profile",
  "format": "txt"
}

Solución de problemas

Problemas con Docker

1. Verifique que Docker esté instalado y en ejecución:

docker --version
docker ps

2. Comprobar los permisos de Docker:

   • Asegúrese de que su usuario tenga permisos para ejecutar comandos de Docker

   • En Linux, agregue su usuario al grupo docker: sudo usermod -aG docker $USER

Informes de problemas del directorio

1. Verificar el directorio de informes:

   • El directorio especificado en MAIGRET_REPORTS_DIR debe existir

   • Su usuario debe tener permisos de escritura en este directorio

   • Comprobar permisos: ls -la /path/to/reports/directory

2. Errores de configuración comunes:

   • Falta la variable de entorno MAIGRET_REPORTS_DIR

   • El directorio no existe

   • Permisos incorrectos

   • Barras finales en la ruta

3. Después de solucionar cualquier problema:

   • Guardar el archivo de configuración

   • Reiniciar Claude Desktop

Mensajes de error

• "Docker no está instalado o no se está ejecutando": Instale Docker e inicie el demonio Docker

• "La variable de entorno MAIGRET_REPORTS_DIR debe estar configurada": Agregue la variable de entorno a su configuración

• "Error al crear el directorio de informes": Verifique los permisos y la ruta del directorio

• "Error al ejecutar maigret": Verifique los registros de Docker y asegúrese de que el contenedor tenga los permisos adecuados

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.