XRPL MCP サーバー

AI モデルに XRP 元帳データと機能へのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

XRPL MCPサーバーは、ClaudeやGPTなどの大規模言語モデル（LLM）とXRP Ledger間の橋渡しとして機能します。これにより、AIモデルは標準化されたAPIインターフェースを介してXRP Ledgerからアカウント情報を取得できるようになります。

特徴

• アカウント情報（残高、シーケンス番号）を取得する
• 信頼ラインと発行通貨の照会
• アカウントが所有するNFTを表示する
• 取引履歴を取得する
• DEXから注文書データにアクセスする
• 署名されたトランザクションをネットワークに送信する
• サーバーのステータス情報を取得する
• MCP を介した信頼性の高い XRP 元帳データへのアクセス
• MCP対応AIアプリケーションとの簡単な統合

インストール

ソースから

1. このリポジトリをクローンします:
   git clone https://github.com/lgcarrier/xrpl-mcp-server.git cd xrpl-mcp-server
2. 仮想環境を作成してアクティブ化します。
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. 依存関係をインストールします:
   pip install -r requirements.txt

pipの使用

構成

サーバーは次の環境変数を使用します。

• XRPL_NODE_URL - XRP LedgerノードのURL（デフォルトは「 https://s1.ripple.com:51234/ 」）

使用法

ソースから実行

サーバーを起動します。

インストールされたパッケージとして実行

Claude やその他の MCP 対応 AI アシスタントと併用する

1. MCP をインストールします。
   mcp install xrpl-mcp-server
2. Claude は XRPL ツールを利用できるようになり、XRP Ledger アカウント情報を要求できるようになります。

利用可能なツール

アカウント情報を取得する

XRP Ledger アカウントに関する情報を取得します。

パラメータ:

• address （文字列）：XRP Ledgerアカウントのアドレス（「r」で始まる）

戻り値:

• XRPのアカウント残高
• アカウントシーケンス番号

アカウントラインを取得する

XRP Ledger アカウントの信頼ラインを取得します。

パラメータ:

• address （文字列）：XRP Ledgerアカウントのアドレス（「r」で始まる）
• peer (文字列、オプション): 結果をフィルタリングする相手方のアカウントのアドレス
• limit (整数、オプション): 返される信頼ラインの数の制限

戻り値:

• アカウントの信頼ラインに関するJSON形式の情報

アカウントを取得

XRP Ledger アカウントが所有する NFT を取得します。

パラメータ:

• address （文字列）：XRP Ledgerアカウントのアドレス（「r」で始まる）
• limit （整数、オプション）：返されるNFTの数の制限

戻り値:

• アカウントのNFTに関するJSON形式の情報

アカウント取引を取得する

XRP Ledger アカウントの取引履歴を取得します。

パラメータ:

• address （文字列）：XRP Ledgerアカウントのアドレス（「r」で始まる）
• limit (整数、オプション): 返されるトランザクション数の制限
• binary （ブール値、オプション）：トランザクションをバイナリ形式で返すフラグ（デフォルトはFalse）
• forward （ブール値、オプション）：元帳履歴を前方に検索するためのフラグ（デフォルトはFalse）

戻り値:

• アカウントの取引履歴に関するJSON形式の情報

get_server_info

接続されている XRP Ledger サーバーに関する情報を取得します。

パラメータ:

• なし

戻り値:

• XRP Ledgerサーバーに関するJSON形式の情報

トランザクションの送信

署名されたトランザクション BLOB を XRP 元帳に送信します。

パラメータ:

• tx_blob (文字列): 16進形式の署名済みトランザクションBLOB

戻り値:

• JSON形式の送信結果

トランザクション情報を取得する

特定のトランザクションに関する情報を取得します。

パラメータ:

• transaction_hash (文字列): トランザクションのハッシュ

戻り値:

• JSON形式の取引詳細

本のオファーを取得する

DEX 上の通貨ペアの注文書オファーを取得します。

パラメータ:

• taker_gets (オブジェクト): テイカーが受け取りたい通貨。例: {"currency": "XRP"}または{"currency": "USD", "issuer": "r..."}
• taker_pays (オブジェクト): テイカーが支払いたい通貨。例: {"currency": "EUR", "issuer": "r..."}または{"currency": "XRP"}
• limit (整数、オプション): 返されるオファーの数の制限

戻り値:

• JSON形式の注文書オファー

例

クロードに聞く:

XRPアカウントrPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYeの残高はいくらですか？

その後、Claude はget_account_infoツールを使用して、この情報を XRP Ledger から直接取得できます。

応答例:

次に別の例を示します。

アカウント rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe はどのような NFT を所有していますか?

Claude はget_account_nftsツールを使用してこの情報を取得できます。

発達

アーキテクチャ、コーディング ルール、実装計画に関する詳細なドキュメントについてはmemory-bankディレクトリを参照してください。

開発環境をセットアップするには:

ライセンス

MITライセンス