xrpl-identity-mcp

xrpl-identity-mcp

xrpl-identity-mcp は、XRP Ledger 向けの初のアイデンティティ特化型 MCP サーバーです。DID（XLS-40）、認証情報（XLS-70）、マルチシグの署名者リスト、安全なトランザクションの準備／検証／送信ワークフローに対応しています。署名されていないトランザクションを準備し、レジャーの状態を読み取り、署名済みのデータを意図と照合して検証できます。また、鍵を預かることなく、事前署名済みのデータを送信できます。

SciPHR を開発したチームのメンバーである Jarod Vyent が開発しました。

セキュリティモデル

次の不変条件は、基本的な動作として組み込まれています。

1. 鍵を預かりません。 サーバーにはシード、秘密鍵、ニーモニック、ウォレットのインポート機能、署名機能がありません。署名はユーザーのウォレットまたはエージェントで行います。
2. ネットワークを明示します。 XRPL_NETWORK は mainnet、testnet、devnet のいずれかです。デフォルトは testnet です。すべてのツールの結果に network が含まれます。
3. メインネットへの送信はオプトインです。 メインネットでの tx_submit_signed は、ALLOW_MAINNET_SUBMIT=true が設定されていない限りブロックされます。
4. 準備、検証、送信の順に行います。 書き込みワークフローでは、外部で署名するための手順を含む署名されていない JSON が返されます。その後、tx_decode_verify を呼び出して検証し、最後に tx_submit_signed を呼び出します。

クイックスタート

Claude MCP：

claude mcp add xrpl-identity -- npx -y xrpl-identity-mcp

汎用 MCP クライアントの設定：

{
  "mcpServers": {
    "xrpl-identity": {
      "command": "npx",
      "args": ["-y", "xrpl-identity-mcp"],
      "env": {
        "XRPL_NETWORK": "testnet"
      }
    }
  }
}

環境変数：

変数	値	デフォルト	用途
XRPL_NETWORK	mainnet、testnet、devnet	testnet	XRPL ネットワークを選択します。
XRPL_ENDPOINT	WebSocket URL	ネットワークのデフォルト	rippled の WebSocket エンドポイントを上書きします。
ALLOW_MAINNET_SUBMIT	true または未設定	未設定	メインネットで tx_submit_signed を実行するために必要です。

デフォルトのエンドポイント：

ネットワーク	エンドポイント
mainnet	wss://xrplcluster.com
testnet	wss://s.altnet.rippletest.net:51233
devnet	wss://s.devnet.rippletest.net:51233

ツール

ツール	機能	ネットワークへの書き込み
did_resolve	XLS-40 DID オブジェクトを解決し、存在する場合は ipfs:// または https:// の DID ドキュメントを取得します。	いいえ
did_prepare_set	署名されていない DIDSet トランザクションを準備します。	いいえ
did_prepare_delete	署名されていない DIDDelete トランザクションを準備します。	いいえ
credential_prepare_create	署名されていない CredentialCreate トランザクションを準備します。	いいえ
credential_prepare_accept	署名されていない CredentialAccept トランザクションを準備します。	いいえ
credential_prepare_delete	署名されていない CredentialDelete トランザクションを準備します。	いいえ
credential_verify	認証情報オブジェクトを読み取り、その存在、受諾状況、有効期限を報告します。	いいえ
credential_list	発行者／対象者で絞り込んで、アカウントから確認できる認証情報オブジェクトを最大400件一覧表示します。	いいえ
account_identity_summary	アカウントの認証状況、署名者リスト、DID の有無、認証情報の件数を要約します。	いいえ
signer_list_prepare_set	マルチシグの作成、置き換え、削除に使用する署名されていない SignerListSet トランザクションを準備します。	いいえ
tx_decode_verify	署名済みデータをデコードしてハッシュを計算し、想定される意図と照合します。	いいえ
tx_submit_signed	事前署名済みのデータを送信し、検証されるまでポーリングします。メインネットでは ALLOW_MAINNET_SUBMIT=true が必要です。	はい

エージェントのフロー例

DID を解決してドキュメントを読み取る：

1. address にクラシック XRPL アドレスまたは did:xrpl:<address> を設定して、did_resolve を呼び出します。
2. decoded.URI、decoded.Data、decoded.DIDDocument を確認します。
3. URI が ipfs:// または https:// の場合は、document と documentSource を確認します。インラインで表示されるのはテキストと JSON ドキュメントのみです。バイナリコンテンツ（画像など）の場合は、本文が省略された理由を示す documentSkipped とともに、documentSource、documentContentType、documentByteLength が返されます。

テストネットでクレデンシャルを発行して受け入れる：

1. XRPL_NETWORK=testnet を設定します。
2. 発行者、サブジェクト、クレデンシャルタイプ、有効期限（任意）、URI（任意）を指定して、credential_prepare_create を呼び出します。
3. 返された unsignedTx に、発行者のアカウントを使って外部で署名します。
4. 署名済みの blob と期待されるインテントを指定して、tx_decode_verify を呼び出します。
5. tx_submit_signed を呼び出します。
6. サブジェクトに対して credential_prepare_accept を呼び出し、外部で署名してから、tx_decode_verify で検証し、送信します。
7. credential_verify を呼び出して、accepted: true と expired: false を確認します。

送信前に署名済み blob を検証する：

1. signedBlob と、トランザクション JSON の一部を指定した expectedIntent を使って、tx_decode_verify を呼び出します。
2. matches と、あれば mismatches を確認します。
3. デコードされたトランザクションがユーザーのインテントと一致する場合にのみ送信します。

開発

npm install
npm run typecheck
npm run build
SKIP_INTEGRATION=1 npm test

統合テストはテストネットを対象としており、SKIP_INTEGRATION=1 の場合はスキップされます。アカウント概要の統合テストを実行するには、資金があるテストネットアカウントのアドレスを XRPL_INTEGRATION_ACCOUNT に設定します。

ライセンス

MIT