Tencent Ekyc Mcp Server

by FrogOVO

332 downloads

Not rated

GitHub

Other

About

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

Details

Author: FrogOVO
Downloads: 332
Categories: Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Tencent Ekyc Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Prerequisites: Node.js >= 20, a Tencent Cloud account with eKYC enabled, and a SecretId/SecretKey from the Tencent Cloud Console. After cloning the repository, run npm install && npm run build, then configure the MCP server in your AI client (e.g., Claude Desktop) by adding a tencent-ekyc entry to the mcpServers section of its configuration file with environment variables TENCENT_SECRET_ID, TENCENT_SECRET_KEY, and optionally TENCENT_REGION and EKYC_LOG_LEVEL. Restart the client to see the tools. Simply describe your KYC task in natural language and the AI agent will call the appropriate tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Tencent Cloud eKYC MCP Server

Features

Supported Regions & Documents

Quick Start

Prerequisites

Install & Build

Configure Claude Desktop

Usage (Natural Language)

Available Tools

Project Structure

Environment Variables

Development

Inspect MCP tools via MCP Inspector

Run tests

License

Related Links

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀