Skip to main content
Glama

Servidor MCP Maigret

insignia de herrería

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:

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

npm install -g mcp-maigret
  1. Crear un directorio de informes:

mkdir -p /path/to/reports/directory
  1. 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

  1. 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
  1. 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
  1. 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.

Available Tools

2 tools
parse_urlC

Parse a URL to extract information and search for associated usernames

Inputs: url (required), format.

search_usernameB

Search for a username across social networks and sites

Inputs: username (required), tags, format, use_all_sites.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools have distinct primary inputs: a username versus a URL. However, parse_url also searches for associated usernames, creating some overlap with search_username that could cause an agent to hesitate when starting from a URL.

    Naming Consistency5/5

    Both tools use a clean, consistent snake_case verb_noun pattern: search_username and parse_url. The convention is predictable and easy to scan.

    Tool Count3/5

    Two tools is thin for an OSINT username/URL search server, though it may reflect a narrow wrapper around Maigret. It is borderline rather than clearly mismatched.

    Completeness3/5

    The surface covers basic username searching and URL parsing, but lacks obvious supporting operations such as listing supported sites, retrieving structured results, or exporting reports. Agents may hit dead ends when they need more than a raw search.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables OSINT research by searching usernames across hundreds of social networks and websites, and analyzing URLs to extract information and find associated usernames using the Maigret tool.
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      A comprehensive MCP server providing tools for IP, domain, email, and image-based open-source intelligence. It integrates services like Shodan, VirusTotal, and HaveIBeenPwned to facilitate advanced security research and data gathering.
      56
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server that exposes multiple OSINT tools to AI assistants like Claude, enabling sophisticated reconnaissance and information gathering tasks using industry-standard OSINT tools.
      250
      MIT