内容
# 腾讯云 eKYC MCP 服务器
一款将腾讯云 eKYC API 封装为 AI 代理（如 Claude Desktop、Cursor、Windsurf 等）可调用工具的 Model Context Protocol (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
### 安装与构建
```bash
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`:
```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 代理对话：
```
请使用此人的 KTP 照片和自拍视频验证其身份。
```
代理将自动调用 `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 服务器入口点
├── auth/tc3-signer.ts # TC3-HMAC-SHA256 签名
├── config/
│ ├── documents.ts # 支持的证件矩阵
│ └── env.ts # 环境变量验证
├── enhancer/
│ ├── error-mapper.ts # 错误码 → AgentHint 映射
│ └── response-enhancer.ts # 响应增强
├── tools/
│ ├── verify-identity.ts # KYC 验证工具
│ ├── detect-deepfake.ts # 深度伪造检测工具
│ ├── supported-docs.ts # 证件查询工具
│ ├── check-quality.ts # 图像质量工具
│ └── verification-status.ts # 状态查询工具
└── utils/logger.ts # 结构化 stderr 日志记录器
```
## 环境变量
| 变量 | 必需 | 描述 |
|----------|----------|-------------|
| `TENCENT_SECRET_ID` | 是 | 腾讯云 API Secret ID |
| `TENCENT_SECRET_KEY` | 是 | 腾讯云 API Secret Key |
| `TENCENT_REGION` | 否 | API 地区（默认：`ap-singapore`） |
| `EKYC_LOG_LEVEL` | 否 | 日志级别：`info` / `debug`（默认：`info`） |
## 开发
```bash
# 以开发模式运行（tsx，热重载）
npm run dev
# 通过 MCP Inspector 检查 MCP 工具
npm run inspect
# 运行测试
npm test
```
## 许可证
Apache License 2.0
## 相关链接
- [腾讯云 eKYC 文档](https://www.tencentcloud.com/dynamic/ebook/1186)
- [Model Context Protocol 规范](https://modelcontextprotocol.io/)
- [MCP 服务器示例](https://github.com/modelcontextprotocol/servers)
---
**关键词**：MCP，Model Context Protocol，人脸识别，人脸验证，身份验证，KYC，eKYC，活体检测，深度伪造检测，印度尼西亚 KTP，腾讯云
