Verifier

🚀 🧠 MCP PID Wallet 検証器

このサーバーは、軽量でAIに適した MCP サーバー です。任意の AIエージェント または MCP プロトコルに準拠したアシスタント が、OIDC4VP を通じて PID（個人識別データ）クレデンシャル ベースの提示を開始し、検証することを可能にします。

このサーバーは、安全なQRコードウォレットのやり取り をサポートするように設計されており、Cline、OpenAIのGPTs（カスタムツールを通じて）、またはMCPプロトコルに準拠した任意のカスタムクライアントと連携して使用できます。

🚀 クイックスタート

このサーバーは、軽量でAIに適した MCP サーバー です。任意の AIエージェント または MCP プロトコルに準拠したアシスタント が、OIDC4VP を通じて PID（個人識別データ）クレデンシャル ベースの提示を開始し、検証することを可能にします。

このサーバーは、安全なQRコードウォレットのやり取り をサポートするように設計されており、Cline、OpenAIのGPTs（カスタムツールを通じて）、またはMCPプロトコルに準拠した任意のカスタムクライアントと連携して使用できます。

✨ 主な機能

• ✅ OIDC4VP ドラフト - 13 および direct_post 応答モードをサポート
• ✅ クレデンシャル提示用の2ステップの 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. 検証済みの属性（例：名前、生年月日）を抽出して使用する

以下の用途に最適です。

• 認証プロセス
• サービスの登録と開通
• コンプライアンスと反マネーロンダリングの自動化
• 政府レベルのAIアプリケーション

🛠️ 技術スタック

• Python + Flask
• セッション処理に Redis を使用
• JWT 署名/検証に jwcrypto を使用
• base64 エンコードされたQR画像生成に qrcode を使用
• EUDI 標準に準拠したウォレットと SD - JWT と互換性がある

📄 MCP ツールの検出

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

利用可能なツール、入力モード、および説明を記述した JSON マニフェストを返します。

🧪 サンプルエージェントの利用可能

以下のエンドポイントを呼び出すことで、ローカルまたはスクリプト化されたエージェントを使用してこのサーバーをテストできます。

• 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