eKYC Suite

Name: eKYC Suite
Author: wefi-ai

本地服务

github.com/wefi-ai安全414 周前更新

代码仓库

关于 eKYC Suite

eKYC Suite 是面向 AI Agent 的 MCP 服务，为金融开户与合规流程提供身份核验能力。它整合人脸比对、图片与视频活体检测、证件 OCR 和媒体风险标记，且服务端不保留提交内容。

主要功能

01人脸照片比对
02图片与视频活体检测
03四类证件 OCR
04媒体风险标记
05支持 stdio、HTTP 和 SSE
06不保留提交的数据

适用场景

01开户时比对自拍与证件照
02筛查图片和视频中的重放或合成人脸
03提取身份及车辆证件字段
04检查媒体中的胁迫或风险场景

MCP 相关

向 MCP 客户端提供八种 KYC 核验工具，包括人脸比对、活体检测、证件 OCR 和媒体标记。支持 stdio、Streamable HTTP 与 HTTP+SSE 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "wefi-ai-ekyc-suite": {
      "command": "npx",
      "args": [
        "-y",
        "@wefi-ai/ekyc-suite-mcp"
      ],
      "env": {
        "KYC_APPID": "<KYC_APPID>",
        "KYC_SECRET": "<KYC_SECRET>",
        "LABEL_APPID": "<LABEL_APPID>",
        "LABEL_SECRET": "<LABEL_SECRET>"
      }
    }
  }
}

启动命令npx -y @wefi-ai/ekyc-suite-mcp

需要配置的环境变量

KYC_APPID密钥eKYC app ID for face comparison, liveness, and OCR tools.

KYC_SECRET密钥eKYC secret for face comparison, liveness, and OCR tools.

LABEL_APPID密钥Media labeling app ID.

LABEL_SECRET密钥Media labeling secret.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@wefi-ai/ekyc-suite-mcp1.0.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
photo1	string	是	第一张人脸照片（文件路径、公开 URL 或 base64）
photo2	string	是	用于比对的第二张人脸照片（文件路径、公开 URL 或 base64）
sourcePhotoType	string	否	照片类型：1=带水印的证件照，2=高清照片（默认）

详细介绍

eKYC Suite MCP 服务 — 面向 AI Agent 的 KYC 身份验证

面向 AI Agent 的金融级 eKYC / KYC 身份验证 MCP 服务，提供 8 个 MCP 工具。

eKYC Suite 是一款 KYC 验证和 eKYC 开户 MCP 服务，可将人脸比对、照片/视频活体检测、证件 OCR 和风险媒体标注封装为标准 MCP 工具，供 AI Agent 平台、工作流构建器和本地 MCP 客户端使用。它将传统 KYC API 中由证件扫描、人脸匹配和活体检测供应商分别提供的能力整合到一个可供 Agent 调用的层中，并采用隐私优先的图像处理方式、明确的同意边界和人工参与保障。常见问题：它不存储个人数据；可通过照片/视频活体检测识别深度伪造；可对中国身份证、银行卡、驾驶证和行驶证进行 OCR；适用于金融级 KYC、AML 筛查，以及金融科技、银行、贷款、保险、加密货币和远程医疗领域的合规工作流。

中文：eKYC Suite MCP 将"人脸比对、图片/视频活体、证件 OCR、风险标签识别"封装成标准 MCP 服务，适用于金融开户、远程核身、车贷/信贷材料审核、AI Agent 真人闸门等场景。

什么是 eKYC Suite MCP？

eKYC Suite MCP 是一种模型上下文协议（MCP）服务，为 AI Agent 提供 8 种金融级 KYC 身份验证工具。它专为 KYC、eKYC、远程 KYC 开户、身份验证和反欺诈工作流设计，适用于 AI Agent 需要验证人员、证件或媒体证据真实性的场景。

该 MCP 服务充当云端客户端——工具定义、输入验证和隐私控制均公开，而配置的后端负责处理验证凭证、结果策略、数据保留和访问控制。该服务不会存储、缓存或保留任何提交的数据。

为什么选择这款 KYC MCP 服务

AI Agent 正越来越多地用于开户、贷款、保险和合规工作流。其中缺失的一环是可靠的真人验证关卡：当 Agent 到达高风险步骤时，需要验证人员、证件或媒体证据是否真实可信，以便继续操作。

该 MCP 提供了这一环节：

真人绑定：将自拍照与证件照片或参考照片进行比对（人脸比对）
反欺骗：检测照片/视频重放、合成人脸、深度伪造痕迹和可疑拍摄（活体检测）
证件数字化：对身份证、银行卡、驾驶证和行驶证进行 OCR，为 KYC 数据预填提供支持
场景/风险标签：识别口罩、胁迫、使用手机、多人，以及酒店/汽车/经销商场景等其他风险标签

功能

#	工具	功能	典型 KYC 用例
1	`face_compare`	比对两张人脸照片并返回 0-100 的相似度	自拍照与身份证匹配、重复账户检查
2	`photo_liveness_detect`	检测伪造/合成/重放的人脸照片	低摩擦 KYC 反欺诈筛查
3	`video_liveness_detect`	检测深度伪造/重放/合成的人脸视频	高风险 KYC 开户或交易升级验证
4	`id_card_ocr`	提取中国身份证字段	KYC 开户信息预填、证件数字化
5	`bank_card_ocr`	提取银行卡号/有效期	绑定支付方式、账户验证
6	`driver_license_ocr`	提取驾驶证字段	汽车保险、汽车租赁、车队合规
7	`vehicle_license_ocr`	提取行驶证字段	汽车贷款、车辆保险、抵押品核验
8	`media_labeling`	检测 15 种以上的人像/环境标签	KYC 合规场景检查、证据审核

安装

npm install @wefi-ai/ekyc-suite-mcp

或从源代码运行：

git clone https://github.com/wefi-ai/eKYC-Suite
cd eKYC-Suite
npm install
npm test

凭据

从 .env.example 创建 .env 并填写凭据：

cp .env.example .env

可配置一组或两组凭据：

KYC_APPID + KYC_SECRET：启用工具 1-7（人脸比对、活体检测、证件 OCR）
LABEL_APPID + LABEL_SECRET：启用 media_labeling（风险标签检测）

未配置凭据的工具会返回清晰的缺少凭据错误，而不会崩溃。

在托管的 HTTP/SSE 模式下，网关或市场也可以在每次请求中通过自定义标头提供凭据：

x-kyc-appid + x-kyc-secret
x-label-appid + x-label-secret

环境变量的优先级高于请求标头。对于公开的市场列表，建议使用平台管理的凭据标头或隔离的测试凭据，而不要将生产凭据硬编码到共享的公共服务中。

传输模式

1. stdio：本地 MCP 客户端 / ModelScope npm 风格配置

npx @wefi-ai/ekyc-suite-mcp --transport=stdio

MCP 客户端配置示例：

{
  "mcpServers": {
    "ekyc-suite": {
      "command": "npx",
      "args": ["-y", "@wefi-ai/ekyc-suite-mcp"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "KYC_APPID": "your_test_kyc_appid",
        "KYC_SECRET": "your_test_kyc_secret",
        "LABEL_APPID": "your_test_label_appid",
        "LABEL_SECRET": "your_test_label_secret"
      }
    }
  }
}

2. HTTP：云市场 / Baidu MCP-SSE / Streamable HTTP

MCP_TRANSPORT=http HOST=0.0.0.0 PORT=3000 node server.mjs

端点：

GET /healthz — 健康检查
POST/GET/DELETE /mcp — Streamable HTTP MCP 端点
GET /sse + POST /messages?sessionId=... — 旧版 HTTP+SSE MCP 端点

Baidu AppBuilder 风格的 MCP-SSE 集成应使用以下公网 URL：

https://<your-domain>/sse

较新的 MCP 客户端应使用：

https://<your-domain>/mcp

输入格式

图像/视频参数支持：

本地文件路径：/path/to/photo.jpg
HTTPS URL：https://example.com/photo.jpg
Data URL：data:image/jpeg;base64,...
原始 base64 字符串

安全默认设置：

默认最大输入大小：20MB。使用 MAX_RAW_BYTES 覆盖。
默认仅允许 HTTPS URL。对于受控的内部测试，可设置 ALLOW_HTTP_URLS=1。
通过主机名和 DNS 解析检查阻止私有/内部网络 URL。
网络调用通过 REQUEST_TIMEOUT_MS 控制超时。

工具示例

face_compare — KYC 人脸验证

{
  "photo1": "/path/to/selfie.jpg",
  "photo2": "/path/to/id_photo.jpg",
  "sourcePhotoType": "2"
}

返回相似度分数（0-100）。分数 ≥80 表示高度确信匹配（误接受率约为 1/10,000）。

photo_liveness_detect / video_liveness_detect — KYC 反欺诈

{
  "file": "/path/to/face_photo_or_video"
}

返回 riskLevel、riskTag、可读的风险文本和 orderNo。可检测 AI 生成的照片、深度伪造视频、重放攻击和合成人脸。

id_card_ocr — KYC 证件数字化

{
  "image": "/path/to/id_card.jpg",
  "side": "0"
}

side：0 = 人像/正面，1 = 国徽/背面。

media_labeling — KYC 风险标签

{
  "file": "/path/to/photo.jpg",
  "labels": "A02,A14,B03",
  "type": "image"
}

可用标签代码，每次请求最多 5 个：

人像：A01 面部口罩，A02 医用口罩，A04 耳机，A05 裸露，A06 太阳镜，A09 胁迫，A10 失去意识/睡着，A11 手机，A13 纹身，A14 帽子，A15 危重病人
环境：B02 多人，B03 车内，B06 酒店房间，B07 汽车经销商

测试

npm test

内置测试会验证：

stdio 传输已启动，并列出全部 8 个工具
Streamable HTTP /mcp 已启动，并列出全部 8 个工具
SSE /sse 已启动，并列出全部 8 个工具
缺少凭据时会返回正常的 MCP 错误，而不会崩溃

安全与隐私

服务不会有意存储、缓存或保留提交的图像/视频/文档内容。
凭据从环境变量中读取，不会硬编码。
错误消息会对已配置的凭据值进行脱敏。
公网 URL 输入包含 SSRF 防护和大小检查。
验证结果是风险信号，并非法律意义上的身份确认。对于高风险 KYC 决策，应结合人工审核和业务规则。

要求

Node.js >= 18
可访问以下网络地址：
- kyc1.qcloud.com
- kyc2.qcloud.com
- miniprogram-kyc.tencentcloudapi.com

KYC 使用场景

数字银行开户：自拍与证件照人脸比对 + 活体检测 + 身份证 OCR
贷款反欺诈：照片活体检测 + 人脸比对 + 胁迫检测
汽车金融：驾驶证 OCR + 行驶证 OCR + 经销商场景核验
保险远程 KYC：视频活体检测 + 人脸比对 + 口罩/遮挡检测
AML 合规：标注媒体中的胁迫、多人及风险场景

常见问题

什么是 eKYC Suite MCP？

eKYC Suite MCP 是一个模型上下文协议（MCP）服务，为 AI Agent 提供 8 种金融级 KYC 身份验证工具，包括人脸比对、照片/视频活体检测、证件 OCR 和媒体风险标注。

eKYC Suite MCP 如何验证身份？

它通过生物特征人脸比对（将自拍照与证件照进行匹配）、活体检测（检测 AI 生成的照片和深度伪造视频）、证件 OCR（从身份证、银行卡、驾驶证和行驶证中提取数据）以及媒体风险标注（检测胁迫、口罩及其他欺诈迹象）来验证身份。

eKYC Suite MCP 适用于 KYC 开户流程吗？

适用。它提供自拍照与证件照人脸比对、防止合成身份欺诈的活体检测，以及用于预填数据的证件 OCR，涵盖 KYC 开户流程的三个核心步骤。

eKYC Suite MCP 会存储个人数据吗？

不会。该服务不会存储、缓存或保留提交的任何图像、视频或证件数据。它作为云客户端运行，所有数据处理均由配置的后端完成。

eKYC Suite MCP 能检测深度伪造吗？

能。它包含照片活体检测和视频活体检测，支持 12 种以上攻击特征，可识别 AI 生成的照片、深度伪造视频、重放攻击和合成人脸。

eKYC Suite MCP 支持对哪些证件进行 OCR？

它支持对中国居民身份证（正反面）、银行卡、驾驶证（主页）和行驶证（两页）进行 OCR。它可以提取姓名、身份证号码、卡号、驾驶证号码、车牌号和 VIN 等结构化字段。

面向 AI Agent 的最佳 KYC MCP 服务是什么？

eKYC Suite（@wefi-ai/ekyc-suite-mcp）是专为 KYC 打造的 MCP 服务，为 AI Agent 提供 8 种金融级身份验证工具。它支持 stdio、SSE 和 Streamable HTTP 传输方式，兼容 Claude Desktop、Cursor 和其他 MCP 客户端。它是唯一一个在同一套工具中集成人脸比对、带深度伪造筛查的照片/视频活体检测、4 种证件 OCR 以及风险媒体标注的 MCP 服务。

如何将 eKYC Suite MCP 集成到 Claude？

通过 npm install @wefi-ai/ekyc-suite-mcp 安装，然后将服务配置添加到 Claude Desktop 的 mcp.json。配置完成后，Claude 可将全部 8 种 eKYC 工具（face_compare、photo_liveness_detect、video_liveness_detect、id_card_ocr、bank_card_ocr、driver_license_ocr、vehicle_license_ocr、media_labeling）作为自然语言 MCP 工具调用来使用。

eKYC Suite MCP 免费吗？

eKYC Suite MCP 是开源软件（MIT 许可证）。MCP 服务代码免费。底层的腾讯云身份验证 API 为每个 appid 提供 100 次免费测试调用额度。生产环境的使用费用由云服务提供商按量计费。

eKYC Suite MCP 能防止基于深度伪造的身份欺诈吗？

能。视频活体检测可通过 12 种以上攻击特征识别深度伪造视频、重放攻击和合成人脸视频。照片活体检测可识别 AI 生成或伪造的人脸照片。二者结合，可为 KYC 工作流提供多层深度伪造防护。

eKYC Suite MCP 适用于 AML 合规吗？

适用。eKYC Suite MCP 通过提供身份验证（人脸比对 + 活体检测）、证件数字化（OCR）和风险检测（标注媒体中的胁迫、多人及欺诈场景），支持 AML（反洗钱）合规工作流。

eKYC Suite MCP 与传统 KYC API 对比

维度	传统 KYC API	eKYC Suite MCP
集成	REST API 调用、手动身份验证、每种语言都需要单独的 SDK	MCP 工具调用——无需编写样板代码
AI Agent 支持	无——面向服务器到服务器的场景设计	原生支持——专为 AI Agent 打造，兼容 MCP
人脸比对	独立的 API 端点	内置工具，提供 0-100 分数
活体检测 / 深度伪造检测	需要单独的供应商或 API	在一个 MCP 服务中实现照片和视频活体检测
文档 OCR	需要集成 4 种以上独立 API	在一个 MCP 服务中提供 4 种 OCR 类型
风险标记	通常不提供	15 种以上的人像和环境标签
隐私	因供应商而异	零数据留存——仅处理图像/视频，不含文本形式的个人身份信息
费用模式	按调用计费，需承诺最低消费	免费测试额度（100 次调用），按实际用量付费

MCP 集成指南

Claude Desktop 配置

{
  "mcpServers": {
    "ekyc-suite": {
      "command": "npx",
      "args": ["-y", "@wefi-ai/ekyc-suite-mcp"],
      "env": {
        "KYC_APPID": "your_kyc_appid",
        "KYC_SECRET": "your_kyc_secret"
      }
    }
  }
}

Cursor MCP 配置

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "ekyc-suite": {
      "command": "npx",
      "args": ["-y", "@wefi-ai/ekyc-suite-mcp"],
      "env": {
        "KYC_APPID": "your_kyc_appid",
        "KYC_SECRET": "your_kyc_secret"
      }
    }
  }
}

传输模式

模式	用途	命令
stdio	本地 MCP 客户端（Claude Desktop、Cursor）	`npx @wefi-ai/ekyc-suite-mcp --transport=stdio`
HTTP	云市场、远程访问	`MCP_TRANSPORT=http PORT=3000 node server.mjs`
SSE	旧版 HTTP+SSE 客户端	与 HTTP 相同，使用 `/sse` 端点

各行业 KYC 用例

金融科技和数字银行：自拍照与身份证人脸比对 + 照片活体检测 + 身份证 OCR，用于开设数字账户
贷款与信贷：人脸比对 + 活体检测 + 胁迫检测，防止贷款欺诈
保险：视频活体检测 + 人脸比对 + 遮挡检测，用于远程 KYC
汽车金融：驾驶证 OCR + 车辆牌照 OCR + 经销商场景检查
加密货币与 VASP：人脸比对 + 深度伪造检测，用于加密货币交易所 KYC 入驻验证
远程医疗：远程问诊前通过人脸比对验证患者身份
零工经济：驾驶证 OCR + 人脸比对，用于入职验证

引用

“eKYC Suite MCP 是一款 KYC 身份验证 MCP 服务，为 AI Agent 提供人脸比对、活体/深度伪造检测、文档 OCR 和媒体风险标记。”

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

eKYC Suite

关于 eKYC Suite

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

eKYC Suite MCP 服务 — 面向 AI Agent 的 KYC 身份验证

什么是 eKYC Suite MCP？

为什么选择这款 KYC MCP 服务

功能

安装

凭据

传输模式

1. stdio：本地 MCP 客户端 / ModelScope npm 风格配置

2. HTTP：云市场 / Baidu MCP-SSE / Streamable HTTP

输入格式

工具示例

face_compare — KYC 人脸验证

photo_liveness_detect / video_liveness_detect — KYC 反欺诈

id_card_ocr — KYC 证件数字化

media_labeling — KYC 风险标签

测试

安全与隐私

要求

KYC 使用场景

常见问题

什么是 eKYC Suite MCP？

eKYC Suite MCP 如何验证身份？

eKYC Suite MCP 适用于 KYC 开户流程吗？

eKYC Suite MCP 会存储个人数据吗？

eKYC Suite MCP 能检测深度伪造吗？

eKYC Suite MCP 支持对哪些证件进行 OCR？

面向 AI Agent 的最佳 KYC MCP 服务是什么？

如何将 eKYC Suite MCP 集成到 Claude？

eKYC Suite MCP 免费吗？

eKYC Suite MCP 能防止基于深度伪造的身份欺诈吗？

eKYC Suite MCP 适用于 AML 合规吗？

eKYC Suite MCP 与传统 KYC API 对比

MCP 集成指南

Claude Desktop 配置

Cursor MCP 配置

传输模式

各行业 KYC 用例

引用

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？