XRPL MCP サーバー

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

概要

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

Related MCP server: xrpl mcp

特徴

• アカウント情報（残高、シーケンス番号）を取得する

• 信頼ラインと発行通貨の照会

• アカウントが所有する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の使用

pip install xrpl-mcp-server

構成

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

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

使用法

ソースから実行

サーバーを起動します。

python -m xrpl_mcp_server

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

xrpl-mcp-server

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 から直接取得できます。

応答例:

Account: rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
XRP Balance: 25.5
Sequence: 123456

次に別の例を示します。

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

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

発達

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

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

pip install -e ".[dev]"

ライセンス

MITライセンス