🚀 🧠 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_requesthttps://verifier.wallet - provider.com/tools/check_pid_result
🧠 使用场景
此服务器使 AI 代理能够：
- 要求用户呈现其数字身份（PID）。
- 显示可扫描的 QR 码。
- 等待钱包通过 OIDC4VP 返回响应。
- 提取并使用已验证的属性（例如姓名、出生日期）。
非常适合用于：
- 身份验证流程。
- 注册与开通服务。
- 合规性及反洗钱自动化。
- 政府级 AI 应用。
⚠️ 安全注意事项
- 临时数据存储采用 setex 来设置过期时间。
- 使用 HMAC 和 verif_token() 函数进行签名验证，确保凭证的安全性。
🤝 联系方式
如需进一步了解或合作，请联系：
- 邮箱：contact@wallet - provider.com
- 网站：https://www.wallet - provider.com