Tencent Ekyc Mcp Server

Created By

FrogOVO12 days ago

Tencent Cloud eKYC MCP Server — face verification, liveness detection, and identity verification via Model Context Protocol

# ekyc

# face-verification

Overview Content Tools Comments

Overview

Tencent Cloud eKYC MCP Server

A Model Context Protocol (MCP) server that wraps Tencent Cloud eKYC APIs as callable tools for AI agents (Claude Desktop, Cursor, Windsurf, etc.). Enables face verification, liveness detection, deepfake detection, and identity verification — all via natural language.

Features

Face Verification (1:1) — Compare ID card photo with selfie video
Liveness Detection — Anti-spoofing with silent challenge
Deepfake Detection — Detect AI-generated or manipulated face images
Image Quality Check — Pre-verify image quality before KYC submission
Supported Documents Query — List all supported ID types by region
Verification Status Tracking — Check async verification results

Supported Regions & Documents

Region	Documents
Indonesia (ID)	KTP (ID Card), SIM (Driver License)
Malaysia (MY)	MyKad, MyTentera
Thailand (TH)	Thai ID Card
Singapore (SG)	NRIC
Philippines (PH)	UMID, SSS ID
Vietnam (VN)	Chip-based ID
More...	16 regions, 28 document types

Quick Start

Prerequisites

Node.js >= 20
Tencent Cloud account with eKYC service enabled
SecretId & SecretKey from Tencent Cloud Console

Install & Build

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

Configure Claude Desktop

Edit %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"
      }
    }
  }
}

Restart Claude Desktop. You should see tencent-ekyc tools available.

Usage (Natural Language)

Once configured, just talk to your AI agent:

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

The agent will automatically call tencent_ekyc_verify_identity with the correct parameters.

Available Tools

Tool Name	Description
`tencent_ekyc_get_credential_status`	Check if API credentials are configured
`tencent_ekyc_get_supported_documents`	List supported ID documents by region
`tencent_ekyc_check_image_quality`	Validate image quality before submission
`tencent_ekyc_verify_identity`	Full KYC: face comparison + liveness + verification
`tencent_ekyc_detect_deepfake`	Detect deepfake/AI-generated face images
`tencent_ekyc_get_verification_status`	Query async verification result

Project Structure

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

Environment Variables

Variable	Required	Description
`TENCENT_SECRET_ID`	Yes	Tencent Cloud API Secret ID
`TENCENT_SECRET_KEY`	Yes	Tencent Cloud API Secret Key
`TENCENT_REGION`	No	API region (default: `ap-singapore`)
`EKYC_LOG_LEVEL`	No	Log level: `info` / `debug` (default: `info`)

Development

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

# Inspect MCP tools via MCP Inspector
npm run inspect

# Run tests
npm test

License

Apache License 2.0

Keywords: MCP, Model Context Protocol, face recognition, face verification, identity verification, KYC, eKYC, liveness detection, deepfake detection, Indonesian KTP, Tencent Cloud

Server Config

{
  "mcpServers": {
    "tencent-ekyc": {
      "command": "npx",
      "args": [
        "tencent-ekyc-mcp-prototype@latest"
      ],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<YOUR_SECRET_ID>",
        "TENCENTCLOUD_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Serper MCP ServerA Serper MCP Server

Amap Maps高德地图官方 MCP Server

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

Playwright McpPlaywright MCP server

DeepChatYour AI Partner on Desktop

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

CursorThe AI Code Editor

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.