facehunch

Name: facehunch
Author: facehunch

远程服务

github.com/facehunch搜索与检索03 周前更新

代码仓库

关于 facehunch

facehunch 是面向账户持有者的只读 MCP 连接器，用于查看已保存的照片搜索报告。它读取报告状态、访问信息和已存来源链接，不会发起搜索或识别人物。

主要功能

01读取已登录账户信息
02列出已拥有的报告及状态
03获取报告元数据和来源链接
04遵守锁定结果的访问限制

适用场景

01查看已保存报告的日期和状态
02总结可访问的来源链接
03检查报告访问权限，锁定时返回产品链接

MCP 相关

它通过本地 stdio 桥接或远程 URL 将 MCP 客户端连接到托管的 Facehunch MCP 服务。工具只读访问账户资料和已拥有的报告。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.facehunch.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http facehunch https://mcp.facehunch.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"facehunch":{"type":"http","url":"https://mcp.facehunch.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"facehunch":{"type":"http","url":"https://mcp.facehunch.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"facehunch":{"type":"http","url":"https://mcp.facehunch.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"facehunch":{"serverUrl":"https://mcp.facehunch.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npmfacehunch-mcp1.2.1stdio

工具

详细介绍

Facehunch MCP

了解照片搜索方法，同时明确其局限。

Facehunch 帮助读者了解照片搜索方法、来源页面，以及视觉搜索结果的局限。相关指南会区分查找某张照片的副本与跨不同照片进行人脸比对。该工作区提供虚构示例和经同意的 API 测试；当前的 FaceCheck 测试索引无法生成可靠的身份匹配结果。

网站 · MCP 仓库 · Agent 技能 · npm 包

此连接器的功能

此软件包会将本地 stdio MCP 客户端连接到托管的 Facehunch MCP 服务。托管工具在 Cloudflare 上运行；本地软件包负责桥接连接并打开基于浏览器的 OAuth 流程。你无需部署 Worker，也无需将产品密码粘贴到助手中。

工具	功能
`get_profile`	读取已登录账号的相关信息。
`list_reports`	列出账号已有的报告，并提供状态和访问权限元数据。
`get_report`	获取账号已有报告的元数据和可用的已存来源链接，同时遵守结果锁定状态。

此 MCP 不会发起新的面部搜索、识别人物、推断敏感特征或调查个人信息。它只会检索已有且属于用户的报告。锁定的结果会继续隐藏。报告列表为空，表示账号没有已保存的报告，而不是某张照片在网上没有匹配结果。测试结果不能用于身份验证。

示例工作流

找到用户账号中已有的报告。
查看其状态和访问权限；按原样保留返回的日期和来源 URL。
总结已存报告包含的内容，不推断身份，也不将相似度分数视为身份验证。

可以向助手提出的问题

列出我保存的报告及其日期、状态和链接。

打开这份已有报告，总结其中可用的来源链接，但不要识别任何人。

检查这份报告是否可以访问。如果已锁定，请返回其产品链接，不要猜测报告内容。

连接远程 MCP 客户端

打开客户端的自定义 MCP 或连接器设置。
将 https://mcp.facehunch.com/mcp 设为远程服务 URL。
在浏览器中完成 Facehunch 登录，并查看同意页面上的权限。
返回客户端并加载可用工具。

请使用支持 Streamable HTTP MCP 和 OAuth 的客户端。是否能使用自定义连接器取决于客户端和你的账号。仓库公开或 npm 发布，并不代表该集成已获准进入客户端的市场。

Claude Desktop 和其他 stdio 客户端

需要 Node.js 22 或更高版本，并且已有 Facehunch 账号。将以下条目添加到客户端的 MCP 配置中：

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

你也可以在终端运行 npx -y facehunch-mcp 来启动桥接程序。它通过 stdio 使用 MCP 通信；它不是交互式聊天界面。对于支持 MCPB 扩展的桌面客户端，请从 Facehunch 发布页下载 .mcpb 文件。

权限和账户访问

请求的权限范围：profile:read reports:read。旧的仅个人资料连接需要重新连接，并明确批准额外权限，之后才能使用内容工具。

仅批准你主动发起的连接。如果登录页面在新标签页中打开，请完成登录，返回授权页面并刷新。管理或撤销已连接的应用。

该软件包使用固定版本的 mcp-remote 处理 OAuth、PKCE 和本地令牌存储。你电脑上的令牌属于凭据。此连接器使用上方固定的端点，并拒绝通过命令行覆盖端点。此软件包不会索取产品密码或底层提供商凭据。

故障排除

**没有工具或权限不足：**通过浏览器授权重新连接，并检查所选账户。
**列表为空：**确认该账户拥有预期条目。空结果与请求失败不同。
**链接要求你登录：**使用拥有该内容的产品账户打开链接；产品私有链接不是公开分享链接。
**浏览器阻止授权：**查看浏览器显示的错误，并从客户端重新发起已过期的请求。切勿在问题报告中发送 Cookie 或令牌。

添加配套技能

Facehunch Agent 技能介绍了如何选择合适的记录、解读结果并遵守工作流限制：

npx skills add facehunch/agent-skill

了解更多关于 Facehunch 的信息

开发与支持

npm ci
npm test
npm run bundle

报告连接器问题，请提供所用客户端、Node.js 版本和已删减敏感信息的错误内容。发布时，请确保 package.json、manifest.json、server/config.json、server.json 和锁文件中的版本保持一致。GitHub Actions 会发布带版本号的 npm 软件包和 MCPB 资源。MIT 许可证请参阅 LICENSE。