🧠 MCP PID Wallet Verifier

🧠 MCP PID 钱包验证器

一款轻量且适用于 AI 的 MCP 服务，可让任何 AI Agent 或 兼容 MCP 的助手通过 OIDC4VP 发起并验证 PID（个人身份数据）凭证展示。

该服务旨在支持安全的、基于二维码的钱包交互，可与 Cline、OpenAI 的 GPT（通过自定义工具）等 Agent，或遵循 MCP 协议的任何自定义客户端搭配使用。

---

🚀 功能

• ✅ 支持具有 direct_post 响应模式的 OIDC4VP Draft-13
• ✅ 提供用于凭证展示的两步式 MCP REST 工具
• ✅ 生成二维码和 openid-vc:// 深层链接
• ✅ 接收来自兼容 EUDI 钱包的 基于 SD-JWT 的凭证
• ✅ 通过 Redis 会话存储实现无状态运行
• ✅ 通过 .well-known/mcp/tools 完全符合 MCP 规范

---

🔧 提供的工具（MCP REST）

1. initiate_pid_request

启动 OIDC4VP 展示流程。返回二维码和会话 ID。

POST https://verifier.wallet-provider.com/tools/initiate_pid_request

响应

{
  "status": "pending",
  "instructions": "Scan this QR code with your wallet to present a credential.",
  "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": "signature failed"
}

---

🧠 使用场景

该服务可让 AI Agent：

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

非常适用于：

• 身份验证流程
• 用户入驻
• 合规与 KYC 自动化
• 政府级 AI 应用

---

🛠️ 技术栈

• Python + Flask
• 使用 Redis 处理会话
• 使用 jwcrypto 进行 JWT 签名和验证
• 使用 qrcode 生成 Base64 编码的二维码图像
• 兼容符合 EUDI 规范的钱包和 SD-JWT

---

📄 MCP 工具发现

GET https://verifier.wallet-provider.com/.well-known/mcp/tools

返回描述可用工具、输入架构和说明的 JSON 清单。

---

🧪 提供演示 Agent

你可以使用会调用以下地址的本地 Agent 或脚本化 Agent 测试此服务：

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

也可以使用支持 MCP 工具的自定义 GPT / Claude。

---

🛡️ 安全说明

• 临时数据会设置过期时间（setex）
• 通过 verif_token() 验证签名
• 包含过期时间（exp）和 nonce 处理
• 专为安全且便于审计的数字身份操作而设计

---

📬 联系方式

由 Talao 创建
维护者：[email protected]
许可证：Apache V2.0