VerifEye

VerifEye MCP 服务

VerifEye MCP 服务是由 Realeyes 远程托管的 Model Context Protocol（MCP）服务。它将 VerifEye Face API 提供为 AI 助手可调用的工具：分析人脸的表观年龄和性别，以及瞬时情绪和注意力（Identify）；登记人脸，以便之后识别同一个人（Onboard）；将图像与一张已登记的人脸进行比对（Compare）；管理已登记人脸所在的集合。

该服务由 Realeyes 托管，因此无需安装或运行任何内容。本仓库保存其用于 MCP 注册表的公开列表元数据：server.json。

完整文档：https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/

服务 URL

https://verifeye-mcp-server.realeyes.ai/mcp

传输方式：Streamable HTTP。这是该服务唯一的地址。如果注册表或目录中列出了其他地址，请勿连接，并联系我们。

要求

• 一个 VerifEye Developer Console 账户。
• 支持通过 OAuth 连接远程 MCP 服务的 MCP 客户端。

身份验证

该服务使用 OAuth 2.1（使用 PKCE 的授权码模式）。连接时，浏览器会打开 VerifEye 登录和授权页面。你无需在 MCP 客户端中输入 API 密钥：账户的 API 密钥会在服务端解析，绝不会暴露给客户端。

该服务不提供动态客户端注册。ChatGPT、VS Code 和 Codex 使用 Client ID Metadata Document 标识自身，因此无需输入任何内容。Claude、Claude Code、Cursor 和 Gemini CLI 使用预先注册的客户端 ID。

连接客户端

文档中提供了 Claude Code、Claude、ChatGPT、VS Code、Cursor、Gemini CLI 和 Codex 的分步设置说明，包括每个客户端所需的客户端 ID：连接客户端。

例如，在 VS Code 中，将 .vscode/mcp.json 添加到项目根目录：

{
  "servers": {
    "verifeye": { "type": "http", "url": "https://verifeye-mcp-server.realeyes.ai/mcp" }
  }
}

通过 MCP: List Servers 命令启动服务，然后在浏览器打开时登录。

使用服务

连接服务并登录后，用自然语言提出请求，助手便会选择合适的工具。

通过链接提供图像。 图像工具需要 JPEG 或 PNG 图像的公开 URL，VerifEye 会自行获取图像。附加到对话中的图像无法传递给工具，因此请将图像放在可访问的位置，并把链接提供给助手。相比长期公开的 URL，建议使用几分钟后过期的预签名链接。如果服务提供 verifeye_get_upload_url，且客户端能够自行发起 HTTPS 请求，则客户端也可以上传图像。图像要求：文档。

选择区域。 每次调用默认在 EU（eu）运行，除非你指定 US（us）。集合按区域区分，因此操作集合时，每次都要指定同一个区域。

示例提示词

图片链接是占位符：请使用指向您自己的图片的链接。提示词 2 到 5 会层层递进，并使用提示词 2 创建的集合和人脸。

#	提示词	执行结果
1	"估算 https://example.com/photos/visitor.jpg 中人脸的表观年龄和性别。"	verifeye_identify_face 会分析人脸并返回估算结果。不存储人脸或图片。
2	"创建一个名为 front-desk-visitors 的 VerifEye 集合，然后将 https://example.com/photos/visitor-1042.jpg 中的人脸录入其中，并使用外部密钥 visitor-1042。"	verifeye_create_collection 会创建集合，verifeye_onboard_face 会使用该密钥存储人脸模板。录入会存储生物特征数据：请参阅生物特征数据与同意。
3	"https://example.com/photos/today.jpg 中的人是否已在我的 front-desk-visitors 集合中？"	如果照片中是提示词 2 中录入的人，verifeye_identify_face 会使用该集合并返回 Existing，以及 faceId 和密钥；如果是其他人，则返回 NotExisting。不会录入任何人脸。
4	"将 https://example.com/photos/check-in.jpg 中的人脸与 front-desk-visitors 中的 visitor-1042 进行比较。"	verifeye_get_face_by_key 会查找 faceId，verifeye_compare_face 会返回相似度和 VerifEye 的 isMatch 判定结果。
5	"从 front-desk-visitors 中删除 visitor-1042 的人脸。"	verifeye_get_face_by_key 会查找该人脸，verifeye_delete_face 会销毁其模板。此操作无法撤销。

许多客户端会要求您在调用运行前先批准，例如在录入或删除人脸之前。

工具

每个工具都接受 region（eu 或 us，默认为 eu），用于选择图片的处理区域和集合所在区域。集合按区域划分：在 eu 中创建的集合在 us 中不可见。

工具	功能	存储或销毁数据
verifeye_identify_face	分析图片中的人脸，并在指定集合时与集合进行比对以识别身份	否
verifeye_onboard_face	将图片中的人脸录入集合，以便之后识别此人	存储人脸模板
verifeye_compare_face	将图片中的人脸与一个已录入的人脸进行比较	否
verifeye_delete_face	删除一个已录入的人脸	不可逆
verifeye_list_collections	列出账户中的集合，或检查某个集合是否存在	否
verifeye_create_collection	创建一个空集合	否
verifeye_set_collection_description	替换集合的描述	否
verifeye_reset_collection	删除集合中的所有人脸，但保留集合	不可逆
verifeye_delete_collection	删除集合及其中的所有人脸	不可逆
verifeye_get_face_by_key	使用您自己的标识符查找已录入的人脸	否
verifeye_set_face_key	为已录入的人脸关联您自己的标识符	否
verifeye_delete_face_key	移除已录入人脸的标识符	将无法再通过该方式查找人脸
verifeye_get_upload_url	返回一个短时有效的表单，用于上传一张图片	否

每个工具的参数、结果和错误代码请参阅文档。

生物特征数据与同意

这些工具会处理面部（生物特征）数据。您有责任在调用运行前取得有效且知情的同意，并遵守适用于图像中人物的隐私和生物特征数据法规（例如 GDPR、BIPA 和 CCPA）。

• verifeye_onboard_face 会存储面部模板，并在删除前一直保留。
• verifeye_delete_face、verifeye_reset_collection 和 verifeye_delete_collection 会永久销毁面部模板。
• 年龄是对表观年龄的估算，并非年龄的法律证明。性别是人口统计学估算，并非由本人声明的身份属性。面部匹配可作为相似性的证据，但本身不能用于身份核验。
• 工具调用以您的 VerifEye 账户身份运行，并计入账户的使用限额。

链接

• 文档：https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/
• MCP Registry 条目（ai.realeyes/verifeye）：https://registry.modelcontextprotocol.io/v0.1/servers/ai.realeyes%2Fverifeye/versions/latest
• 隐私政策：https://realeyes.ai/privacy-policy/
• 条款：https://realeyes.ai/terms-for-customers/
• 支持：[email protected]