🧠 MCP PID 钱包验证器

一个轻量级且对 AI 友好的 MCP 服务器，允许任何 AI 代理 或 MCP 兼容的助手 通过 OIDC4VP 发起和验证 PID (个人身份数据) 凭证展示。

该服务器旨在支持 安全、基于 QR 码的钱包交互，并且可以与诸如 Cline、OpenAI 的 GPTs (通过自定义工具) 或任何遵循 MCP 协议的自定义客户端一起使用。

---

🚀 功能

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

---

🔧 暴露的工具 (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. 提取并使用已验证的属性 (例如，姓名、出生日期)

非常适合用于：

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

---

🛠️ 技术栈

• Python + Flask
• Redis 用于会话处理
• jwcrypto 用于 JWT 签名/验证
• qrcode 用于生成 base64 编码的 QR 图像
• 兼容 EUDI 兼容的钱包和 SD-JWT

---

📄 MCP 工具发现

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

返回一个 JSON 清单，描述可用的工具、输入模式和描述。

---

🧪 演示代理可用

您可以使用本地或脚本代理来测试此服务器，该代理调用：

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

或者使用支持 MCP 工具的 Custom GPT / Claude。

---

🛡️ 安全注意事项

• 临时数据存储时设置过期时间 (setex)
• 通过 verif_token() 进行签名验证
• 包含过期时间 (exp) 和 nonce 处理
• 专为安全、可审计的数字身份操作而设计

---

📬 联系方式

由 Talao 创建 维护者: thierry.thevenet@talao.io 许可证: Apache V2.0