Tencent Ekyc Mcp Server

Tencent Cloud eKYC MCP Server

AI エージェント（Claude Desktop、Cursor、Windsurf など）向けに、Tencent Cloud eKYC API を呼び出し可能なツールとして提供する Model Context Protocol（MCP）サーバーです。顔認証、ライブネス検出、ディープフェイク検出、本人確認を、すべて自然言語で実行できます。

機能

• 顔認証（1:1） — ID カードの写真と自撮り動画を比較します
• ライブネス検出 — サイレントチャレンジによるなりすまし防止
• ディープフェイク検出 — AI 生成または加工された顔画像を検出します
• 画像品質チェック — KYC の申請前に画像品質を事前確認します
• 対応書類の照会 — 地域別に対応するすべての ID 種別を一覧表示します
• 認証ステータスの追跡 — 非同期の認証結果を確認します

対応地域と書類

地域	書類
インドネシア（ID）	KTP（ID カード）、SIM（運転免許証）
マレーシア（MY）	MyKad、MyTentera
タイ（TH）	タイ ID カード
シンガポール（SG）	NRIC
フィリピン（PH）	UMID、SSS ID
ベトナム（VN）	チップ搭載 ID
その他...	16 地域、28 種類の書類

クイックスタート

前提条件

• Node.js >= 20
• eKYC サービスが有効な Tencent Cloud アカウント
• Tencent Cloud コンソールから取得した 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 エージェントに話しかけるだけです。

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

エージェントは、正しいパラメーターを指定して tencent_ekyc_verify_identity を自動的に呼び出します。

利用可能なツール

ツール名	説明
tencent_ekyc_get_credential_status	API 認証情報が設定されているか確認します
tencent_ekyc_get_supported_documents	地域別に対応する ID 書類を一覧表示します
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	はい	Tencent Cloud API の Secret ID
TENCENT_SECRET_KEY	はい	Tencent Cloud 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

関連リンク

• Tencent Cloud eKYC のドキュメント
• Model Context Protocol の仕様
• MCP サーバーのサンプル

---

キーワード：MCP、Model Context Protocol、顔認識、顔認証、本人確認、KYC、eKYC、ライブネス検出、ディープフェイク検出、インドネシアの KTP、Tencent Cloud