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
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:
- 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 buscarformat (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 principalestags (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 analizarformat (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
- 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.