Facehunch

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

Facehunch MCP

Contexto de busca de fotos com limites claros.

O Facehunch ajuda leitores a entender métodos de busca de fotos, páginas de origem e os limites de um resultado visual. Seus guias distinguem encontrar cópias de uma fotografia de comparar rostos entre diferentes fotografias. O workspace apresenta uma amostra fictícia e testes de API consentidos; o índice de teste atual do FaceCheck não produz correspondências de identidade confiáveis.

Website · Repositório MCP · Habilidade do agente · Pacote npm

O que este conector faz

Este pacote conecta um cliente MCP stdio local ao servidor MCP Facehunch hospedado. As ferramentas hospedadas rodam no Cloudflare; o pacote local faz a ponte da conexão e abre OAuth baseado em navegador. Você não precisa implantar um Worker ou colar uma senha de produto no seu assistente.

Ferramenta	O que faz
get_profile	Lê o contexto da conta conectada.
list_reports	Lista relatórios já pertencentes à conta, com status e metadados de acesso.
get_report	Recupera os metadados de um relatório pertencente à conta e os links de origem armazenados disponíveis, respeitando resultados bloqueados.

O MCP não inicia novas buscas de rosto, não identifica pessoas, não infere características sensíveis nem pesquisa informações pessoais. Ele apenas recupera relatórios existentes pertencentes à conta. Resultados bloqueados permanecem ocultos. Uma lista de relatórios vazia significa que a conta não tem relatórios salvos, não que uma fotografia não tem correspondências online. Resultados de teste não são verificação de identidade.

Fluxo de trabalho de exemplo

1. Localize um relatório que já exista na conta do usuário.
2. Leia o status e o estado de acesso; preserve datas e URLs de origem exatamente como retornadas.
3. Resuma o que o relatório armazenado contém sem inferir identidade nem tratar uma pontuação de similaridade como verificação.

Coisas para perguntar ao seu assistente

Liste meus relatórios salvos com datas, status e links.

Abra este relatório existente e resuma seus links de origem disponíveis sem identificar ninguém.

Verifique se este relatório está acessível. Se estiver bloqueado, retorne o link do produto em vez de adivinhar o conteúdo.

Conecte um cliente MCP remoto

1. Abra as configurações de MCP personalizado ou de conector do cliente.
2. Insira https://mcp.facehunch.com/mcp como URL do servidor remoto.
3. Conclua o login do Facehunch no seu navegador e revise as permissões na tela de consentimento.
4. Volte ao cliente e carregue as ferramentas disponíveis.

Use um cliente que suporte MCP Streamable HTTP e OAuth. A disponibilidade de conectores personalizados depende do cliente e da sua conta. Um repositório público ou lançamento npm não significa que a integração foi aprovada para o marketplace de um cliente.

Claude Desktop e outros clientes stdio

Requer Node.js 22 ou mais recente e uma conta Facehunch existente. Adicione esta entrada à configuração MCP do seu cliente:

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

Você também pode executar npx -y facehunch-mcp a partir de um terminal para iniciar a ponte. Ela fala MCP via stdio; não é uma interface de chat interativa. Para clientes desktop que suportam extensões MCPB, baixe o arquivo .mcpb dos lançamentos do Facehunch.

Permissões e acesso à conta

Escopos solicitados: profile:read reports:read. Conexões antigas apenas com perfil precisam se reconectar e aprovar explicitamente as permissões adicionais antes que as ferramentas de conteúdo estejam disponíveis.

Aprove apenas uma conexão que você pretendia iniciar. Se o login abrir uma nova aba, conclua-o, volte à tela de consentimento e atualize. Gerencie ou revogue aplicativos conectados.

O pacote usa mcp-remote fixado para OAuth, PKCE e armazenamento local de tokens. Tokens no seu computador são credenciais. O conector usa o endpoint fixo acima e rejeita substituições de endpoint por linha de comando. Senhas de produto e credenciais subjacentes do provedor não são solicitadas por este pacote.

Solução de problemas

• Sem ferramentas ou permissões insuficientes: reconecte-se pelo consentimento do navegador e verifique a conta selecionada.
• Lista vazia: confirme que a conta possui os itens esperados. Resultados vazios são diferentes de uma solicitação falha.
• Um link pede login: abra-o com a conta do produto proprietário; um link privado de produto não é um link público de compartilhamento.
• O navegador bloqueia a autorização: inspecione o erro exibido no navegador e reinicie uma solicitação expirada pelo cliente. Nunca envie cookies ou tokens em um problema.

Adicione a habilidade complementar

A habilidade de agente do Facehunch explica como selecionar os registros certos, interpretar resultados e respeitar os limites do fluxo de trabalho:

npx skills add facehunch/agent-skill

Saiba mais sobre o Facehunch

• Busca de fotos e seus limites
• Busca reversa de imagens explicada
• Busca de rosto versus busca reversa de imagens
• Privacidade na busca de fotos
• Central de ajuda do modo de teste
• Remoção de fotos

Desenvolvimento e suporte

npm ci
npm test
npm run bundle

Relate um problema do conector com seu cliente, versão do Node.js e um erro editado. Mantenha package.json, manifest.json, server/config.json, server.json e a versão do lockfile alinhados para lançamentos. O GitHub Actions publica pacotes npm versionados e ativos MCPB. Veja LICENSE para a licença MIT.