Tencent Ekyc Mcp Server

腾讯云 eKYC MCP 服务

一个将腾讯云 eKYC API 封装为可供 AI Agent（Claude Desktop、Cursor、Windsurf 等）调用的工具的模型上下文协议（MCP）服务。通过自然语言即可进行人脸核验、活体检测、深度伪造检测和身份核验。

功能特性

• 人脸核验（1:1） — 比对身份证照片与自拍视频
• 活体检测 — 使用静默挑战的防欺骗检测
• 深度伪造检测 — 检测 AI 生成或篡改的人脸图像
• 图像质量检查 — 在提交 KYC 前预先检查图像质量
• 支持的证件查询 — 按地区列出所有支持的证件类型
• 核验状态跟踪 — 查询异步核验结果

支持的地区和证件

地区	证件
印度尼西亚（ID）	KTP（身份证）、SIM（驾驶证）
马来西亚（MY）	MyKad、MyTentera
泰国（TH）	泰国身份证
新加坡（SG）	NRIC
菲律宾（PH）	UMID、SSS ID
越南（VN）	芯片身份证
更多...	16 个地区，28 种证件类型

快速开始

前置要求

• Node.js >= 20
• 已启用 eKYC 服务的腾讯云账户
• 从腾讯云控制台获取的 SecretId 和 SecretKey

安装和构建

git clone https://github.com/FrogOVO/tencent-ekyc-mcp-server.git
cd tencent-ekyc-mcp-server
npm install
npm run build

配置 Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "tencent-ekyc": {
      "command": "node",
      "args": ["D:\\path\\to\\tencent-ekyc-mcp-server\\dist\\index.js"],
      "env": {
        "TENCENT_SECRET_ID": "your-secret-id",
        "TENCENT_SECRET_KEY": "your-secret-key",
        "TENCENT_REGION": "ap-singapore",
        "EKYC_LOG_LEVEL": "info"
      }
    }
  }
}

重启 Claude Desktop。你应该能看到可用的 tencent-ekyc 工具。

使用方法（自然语言）

配置完成后，直接与你的 AI Agent 对话：

Please verify this person's identity using their KTP photo and selfie video.

Agent 会自动使用正确的参数调用 tencent_ekyc_verify_identity。

可用工具

工具名称	描述
tencent_ekyc_get_credential_status	检查是否已配置 API 凭证
tencent_ekyc_get_supported_documents	按地区列出支持的身份证件
tencent_ekyc_check_image_quality	提交前验证图像质量
tencent_ekyc_verify_identity	完整 KYC：人脸比对 + 活体检测 + 身份核验
tencent_ekyc_detect_deepfake	检测深度伪造或 AI 生成的人脸图像
tencent_ekyc_get_verification_status	查询异步核验结果

项目结构

src/
├── index.ts                    # MCP server entry point
├── auth/tc3-signer.ts         # TC3-HMAC-SHA256 signature
├── config/
│   ├── documents.ts            # Supported document matrix
│   └── env.ts                 # Environment variable validation
├── enhancer/
│   ├── error-mapper.ts         # Error code → AgentHint mapping
│   └── response-enhancer.ts   # Response enrichment
├── tools/
│   ├── verify-identity.ts      # KYC verification tool
│   ├── detect-deepfake.ts     # Deepfake detection tool
│   ├── supported-docs.ts      # Document query tool
│   ├── check-quality.ts        # Image quality tool
│   └── verification-status.ts # Status query tool
└── utils/logger.ts            # Structured stderr logger

环境变量

变量	必填	描述
TENCENT_SECRET_ID	是	腾讯云 API Secret ID
TENCENT_SECRET_KEY	是	腾讯云 API Secret Key
TENCENT_REGION	否	API 地区（默认：ap-singapore）
EKYC_LOG_LEVEL	否	日志级别：info / debug（默认：info）

开发

# Run in dev mode (tsx, hot reload)
npm run dev

# Inspect MCP tools via MCP Inspector
npm run inspect

# Run tests
npm test

许可证

Apache License 2.0

相关链接

• 腾讯云 eKYC 文档
• 模型上下文协议规范
• MCP 服务示例

---

关键词：MCP、模型上下文协议、人脸识别、人脸核验、身份核验、KYC、eKYC、活体检测、深度伪造检测、印度尼西亚 KTP、腾讯云