Verifier

🚀 🧠 MCP PID 錢包驗證器

MCP PID 錢包驗證器是一個輕量級且適配 AI 的 MCP 服務器。它允許任何 AI 代理或遵循 MCP 協議的助手啟動並驗證基於 PID（個人身份數據）憑證的呈現，藉助 OIDC4VP 實現安全的二維碼錢包交互。該服務器可與 Cline、OpenAI 的 GPTs（通過自定義工具）或任何遵循 MCP 協議的自定義客戶端協同工作。

🚀 快速開始

MCP PID 錢包驗證器為安全的二維碼錢包交互提供支持，可與多種客戶端配合使用，開啟基於 PID 憑證的呈現驗證流程。

✨ 主要特性

• ✅ 支持 OIDC4VP 草案 - 13 以及 direct_post 響應模式。
• ✅ 提供兩個步驟的 MCP REST 工具 用於憑證呈現。
• ✅ 自動生成 QR 碼 和 openid - vc:// 深鏈鏈接。
• ✅ 接收來自符合 EUDI 標準的錢包的 基於 SD - JWT 的憑證。
• ✅ 無狀態通過 Redis 會話存儲。
• ✅ 完全遵循 MCP 協議，通過 .well - known/mcp/tools 配置。

🔧 技術細節

🔧 提供的工具（MCP REST）

1. initiate_pid_request

啟動一個 OIDC4VP 憑證呈現流程，返回 QR 碼和會話 ID。 POST https://verifier.wallet - provider.com/tools/initiate_pid_request

響應

{
  "status": "pending",
  "instructions": "掃描此QR碼以使用您的錢包進行憑證呈現。",
  "session_id": "f1203ea7 - d5...",
  "presentation_url": "openid - vc://?client_id=...",
  "qr_code_base64": "data:image/png;base64,..."
}

2. check_pid_result

輪詢憑證呈現的狀態。 POST https://verifier.wallet - provider.com/tools/check_pid_result

請求

{
  "session_id": "f1203ea7 - d5..."
}

可能的響應

• 等待中：

{ "status": "pending" }

• 已驗證：

{
  "status": "verified",
  "verified_credential": {
    "given_name": "Jean",
    "family_name": "Dupont",
    "birth_date": "1975 - 06 - 23"
  }
}

• 錯誤：

{ 
  "status": "error",
  "error_description": "簽名失敗"
}

🛠️ 技術棧

• Python + Flask
• Redis 用於會話處理
• jwcrypto 用於 JWT 簽名/驗證
• qrcode 用於 base64 編碼的 QR 圖像生成
• 兼容於符合 EUDI 標準的錢包和 SD - JWT

📄 MCP 工具發現

GET https://verifier.wallet - provider.com/.well - known/mcp/tools 返回一個 JSON manifest，描述可用工具、輸入模式及說明。

💻 使用示例

基礎用法

您可以使用本地或腳本化的代理測試此服務器，通過調用：

• https://verifier.wallet - provider.com/tools/initiate_pid_request
• https://verifier.wallet - provider.com/tools/check_pid_result

🧠 使用場景

此服務器使 AI 代理能夠：

1. 要求用戶呈現其數字身份（PID）。
2. 顯示可掃描的 QR 碼。
3. 等待錢包通過 OIDC4VP 返回響應。
4. 提取並使用已驗證的屬性（例如姓名、出生日期）。

非常適合用於：

• 身份驗證流程。
• 註冊與開通服務。
• 合規性及反洗錢自動化。
• 政府級 AI 應用。

⚠️ 安全注意事項

• 臨時數據存儲採用 setex 來設置過期時間。
• 使用 HMAC 和 verif_token() 函數進行簽名驗證，確保憑證的安全性。

🤝 聯繫方式

如需進一步瞭解或合作，請聯繫：

• 郵箱：contact@wallet - provider.com
• 網站：https://www.wallet - provider.com