🧠 MCP PID Wallet 验证器

一个轻量级且适合AI的 MCP 服务器，允许任何 AI代理 或遵循 MCP 协议的助手 启动并验证基于 PID（个人身份数据）凭证 的呈现，通过 OIDC4VP。

此服务器设计用于支持 安全的二维码钱包交互，可用于与 Cline、OpenAI 的 GPTs（通过自定义工具）、或任何遵循MCP协议的自定义客户端配合使用。

🚀 功能

• ✅ 支持 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": "签名失败"
}

🧠 使用场景

此服务器使AI代理能够：

1. 要求用户呈现其数字身份（PID）
2. 显示可扫描的QR码
3. 等待钱包通过 OIDC4VP 返回响应
4. 提取并使用已验证的属性（例如姓名、出生日期）

非常适合用于：

• 身份验证流程
• 注册与开通服务
• 合规性及反洗钱自动化
• 政府级AI应用

🛠️ 技术栈

• 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

安全注意事项

• 临时数据存储采用 setex 来设置过期时间。
• 使用 HMAC 和 verif_token() 函数进行签名验证，确保凭证的安全性。

🤝 联系方式

如需进一步了解或合作，请联系：

• 邮箱：contact@wallet-provider.com
• 网站：https://www.wallet-provider.com