🚀 🧠 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