local-only server

The server can only run on the client’s local machine because it depends on local resources.

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.

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

Instalar Docker:
- macOS: Instalar Docker Desktop
- Linux: Siga la guía de instalación de Docker Engine
Instalar el servidor globalmente a través de npm:

npm install -g mcp-maigret

Crear un directorio de informes:

mkdir -p /path/to/reports/directory

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

Reiniciar Claude Desktop

Configuración alternativa (de la fuente)

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

Clonar y construir:

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

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

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

docker --version
docker ps

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

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
Errores de configuración comunes:
- Falta la variable de entorno MAIGRET_REPORTS_DIR
- El directorio no existe
- Permisos incorrectos
- Barras finales en la ruta
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

Bifurcar el repositorio
Crear una rama de características ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

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