Facehunch

npx add-mcp 'https://mcp.facehunch.com/mcp'

Facehunch MCP

Contexto de búsqueda de fotos con límites claros.

Facehunch ayuda a los lectores a comprender los métodos de búsqueda de fotos, las páginas de origen y los límites de un resultado visual. Sus guías distinguen entre encontrar copias de una fotografía y comparar rostros entre diferentes fotografías. El espacio de trabajo presenta una muestra ficticia y pruebas de API consentidas; el índice de prueba actual de FaceCheck no produce coincidencias de identidad fiables.

Sitio web · Repositorio MCP · Habilidad del agente · Paquete npm

Qué hace este conector

Este paquete conecta un cliente MCP stdio local al servidor MCP de Facehunch alojado. Las herramientas alojadas se ejecutan en Cloudflare; el paquete local establece el puente de conexión y abre OAuth basado en navegador. No necesitas implementar un Worker ni pegar una contraseña de producto en tu asistente.

Herramienta	Qué hace
get_profile	Lee el contexto de la cuenta con sesión iniciada.
list_reports	Lista los informes ya propiedad de la cuenta, con estado y metadatos de acceso.
get_report	Recupera los metadatos de un informe propiedad de la cuenta y los enlaces de origen almacenados disponibles, respetando los resultados bloqueados.

El MCP no inicia nuevas búsquedas de rostros, no identifica personas, no infiere rasgos sensibles ni investiga información personal. Solo recupera informes existentes propiedad de la cuenta. Los resultados bloqueados permanecen ocultos. Una lista de informes vacía significa que la cuenta no tiene informes guardados, no que una fotografía no tenga coincidencias en línea. Los resultados de prueba no son verificación de identidad.

Flujo de trabajo de ejemplo

1. Localiza un informe que ya exista en la cuenta del usuario.
2. Lee su estado y estado de acceso; conserva fechas y URL de origen exactamente como se devuelven.
3. Resume lo que contiene el informe almacenado sin inferir identidad ni tratar una puntuación de similitud como verificación.

Cosas que puedes pedir a tu asistente

Lista mis informes guardados con sus fechas, estados y enlaces.

Abre este informe existente y resume sus enlaces de origen disponibles sin identificar a nadie.

Comprueba si este informe es accesible. Si está bloqueado, devuelve su enlace de producto en lugar de adivinar su contenido.

Conectar un cliente MCP remoto

1. Abre la configuración de MCP personalizado o de conectores del cliente.
2. Introduce https://mcp.facehunch.com/mcp como URL del servidor remoto.
3. Completa el inicio de sesión de Facehunch en tu navegador y revisa los permisos en la pantalla de consentimiento.
4. Vuelve al cliente y carga las herramientas disponibles.

Usa un cliente que admita MCP Streamable HTTP y OAuth. La disponibilidad de conectores personalizados depende del cliente y de tu cuenta. Un repositorio público o una versión npm no significa que la integración haya sido aprobada para el mercado de un cliente.

Claude Desktop y otros clientes stdio

Requiere Node.js 22 o superior y una cuenta Facehunch existente. Añade esta entrada a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "facehunch": {
      "command": "npx",
      "args": [
        "-y",
        "facehunch-mcp"
      ]
    }
  }
}

También puedes ejecutar npx -y facehunch-mcp desde una terminal para iniciar el puente. Habla MCP sobre stdio; no es una interfaz de chat interactiva. Para clientes de escritorio que admitan extensiones MCPB, descarga el archivo .mcpb de versiones de Facehunch.

Permisos y acceso a la cuenta

Ámbitos solicitados: profile:read reports:read. Las conexiones antiguas solo de perfil deben reconectarse y aprobar explícitamente los permisos adicionales antes de que las herramientas de contenido estén disponibles.

Solo aprueba una conexión que hayas iniciado intencionalmente. Si el inicio de sesión abre una nueva pestaña, termínala, vuelve a la pantalla de consentimiento y actualiza. Gestiona o revoca aplicaciones conectadas.

El paquete usa mcp-remote fijado para OAuth, PKCE y almacenamiento local de tokens. Los tokens en tu ordenador son credenciales. El conector usa el endpoint fijo anterior y rechaza anulaciones de endpoint desde la línea de comandos. Las contraseñas de producto y las credenciales subyacentes del proveedor no son solicitadas por este paquete.

Solución de problemas

• Sin herramientas o permisos insuficientes: reconéctate mediante el consentimiento del navegador y comprueba la cuenta seleccionada.
• Una lista vacía: confirma que la cuenta posee los elementos esperados. Los resultados vacíos son diferentes de una solicitud fallida.
• Un enlace te pide iniciar sesión: ábrelo con la cuenta del producto propietario; un enlace privado de producto no es un enlace público de compartir.
• El navegador bloquea la autorización: inspecciona el error mostrado en el navegador y reinicia una solicitud caducada desde el cliente. Nunca envíes cookies ni tokens en un problema.

Añadir la habilidad complementaria

La habilidad del agente Facehunch explica cómo seleccionar los registros correctos, interpretar resultados y respetar los límites del flujo de trabajo:

npx skills add facehunch/agent-skill

Aprende más sobre Facehunch

• Búsqueda de fotos y sus límites
• Búsqueda inversa de imágenes explicada
• Búsqueda de rostros frente a búsqueda inversa de imágenes
• Privacidad en la búsqueda de fotos
• Centro de ayuda del modo de prueba
• Eliminación de fotos

Desarrollo y soporte

npm ci
npm test
npm run bundle

Informa de un problema del conector con tu cliente, versión de Node.js y un error redactado. Mantén package.json, manifest.json, server/config.json, server.json y la versión del archivo de bloqueo alineados para las versiones. GitHub Actions publica paquetes npm versionados y activos MCPB. Consulta LICENCIA para la licencia MIT.