🧠 MCP PID Wallet Verifier

🧠 MCP PID Wallet Verifier

あらゆるAI エージェントやMCP 対応アシスタントが、OIDC4VPを介してPID（個人識別データ）クレデンシャルの提示を開始し、検証できる、軽量でAIフレンドリーなMCP サーバーです。

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

---

🚀 機能

• ✅ direct_postレスポンスモードによるOIDC4VP Draft-13をサポート
• ✅ クレデンシャル提示用の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": "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エージェントは次のことができます。

1. ユーザーにデジタルID（PID）の提示を求める
2. スキャン可能なQRコードを表示する
3. OIDC4VP経由でウォレットからの応答を待つ
4. 検証済み属性（名前、生年月日など）を抽出して使用する

次の用途に最適です。

• ID検証フロー
• オンボーディング
• コンプライアンスとKYCの自動化
• 政府機関レベルの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/tools/initiate_pid_request
• https://verifier.wallet-provider.com/tools/check_pid_result

または、MCPツールに対応したCustom GPT / Claudeを使用してください。

---

🛡️ セキュリティに関する注意事項

• 一時データは有効期限付きで保存されます（setex）
• verif_token()による署名検証
• 有効期限（exp）とnonceの処理を含みます
• 安全で監査しやすいデジタルID運用を想定して設計されています

---

📬 お問い合わせ

Talaoが作成
メンテナー：[email protected]
ライセンス：Apache V2.0