remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Used for environment variable management and configuration, allowing the server to securely store sensitive data like wallet seeds and network selection.
Serves as the runtime environment for the MCP server, with version 18.0.0 or higher required as a prerequisite.
Implementation language for the MCP server, providing type safety and modern language features.
XRP 元帳モデルコンテキストプロトコルサーバー
ライセンス: MIT | XRPL Networks | TypeScript | xrpl.js
XRP Ledgerエコシステムにブロックチェーンサービスを提供する包括的なモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIエージェントは統一されたインターフェースを介してXRPL MainNet、TestNet、DevNetとやり取りできるようになります。
📋 目次
🔭 概要
MCP XRPLサーバーは、モデルコンテキストプロトコルを活用して、AIエージェントにXRP Ledgerサービスを提供します。以下の幅広いサービスをサポートしています。
- 元帳の状態（残高、取引、アカウント情報など）の読み取り
- スマートコントラクトとのやり取り（Hooks経由）
- XRPおよび発行トークンの転送
- トークンのメタデータと残高の照会
- 分散識別子（DID）の管理
- XRPLでのNFTの活用
- 自動マーケットメーカー（AMM）の運用
- 支払いチャネル、エスクロー、小切手
- Oracleデータ操作
- トラストライン管理
すべてのサービスは、MCP ツールとリソースの一貫したインターフェースを通じて公開されるため、AI エージェントは XRPL 機能を簡単に検出して使用できます。
✨ 特徴
アカウント管理
- XRPL ネットワーク (MainNet、TestNet、DevNet) に接続する
- アカウント情報の取得
- アカウントプロパティ管理
- 預金の事前承認
- 定期的な鍵管理
XRPとトークンの運用
- アカウント間でXRPを転送する
- トークンのメタデータ（名前、シンボル、小数点、供給）を取得する
- トークン残高を確認する
- アドレス間でトークンを転送する
- トークン支出を承認する
- トークンの回収
NFTオペレーション
- XRP元帳でNFTを発行する
- NFTメタデータを表示
- NFTの所有権を確認する
- アドレス間でNFTを転送する
- NFTコレクションを入手する
分散識別子（DID）
- XRPLでDIDを作成する
- DIDを解決する
- DID文書を更新する
- DIDを非アクティブ化する
AMMオペレーション
- 自動マーケットメーカーを作成する
- AMMへの入金
- AMMに入札する
- AMMパラメータに投票する
- AMMを削除する
- AMMからの資産の回収
操作の確認
- 小切手を作成する
- 現金小切手
- チェックをキャンセルする
オファー/DEXオペレーション
- オファーを作成する
- オファーをキャンセルする
Oracleオペレーション
- Oracleデータの設定
- Oracleデータを削除する
支払いチャネル
- 支払いチャネルを作成する
- 資金支払いチャネル
- 支払いチャネルからの請求
預託
- エスクローを作成する
- エスクローを完了する
- エスクローをキャンセルする
トラストライン
- 信頼ラインの設定と管理
発券業務
- 取引処理用のチケットを作成する
🌐 サポートされているネットワーク
- メインネット: プロダクションXRP元帳ネットワーク
- TestNet : 開発用のテストネットワーク
- DevNet : 実験的な機能の開発ネットワーク
🛠️ 前提条件
- Node.js 18.0.0以上
📦 インストール
⚙️ サーバー構成
次の変数を含む.envファイルをプロジェクト ルートに作成します。
🚀 使用方法
サーバーの起動
サーバーへの接続
MCP対応クライアントを使用して、このMCPサーバーに接続してください。テストとデバッグには、MCP Inspectorをご利用いただけます。
📚 APIリファレンス
ツール
サーバーはエージェントに次の MCP ツールを提供します。
アカウント管理
| ツール名 | 説明 | 主なパラメータ |
|---|---|---|
connect-to-xrpl | シードを使用してXRP Ledgerに接続する | 種子、ネットワーク |
get-account-info | アカウント情報を取得する | アドレス、ネットワーク |
delete-account | XRPLアカウントを削除する | 秘密鍵、宛先、ネットワーク |
set-account-properties | アカウントプロパティを設定する | 秘密鍵、プロパティ、ネットワーク |
deposit-preauth | デポジットの事前承認 | 秘密鍵、承認、ネットワーク |
set-regular-key | アカウントの通常キーを設定する | 秘密鍵、通常鍵、ネットワーク |
XRPとトークンの運用
| ツール名 | 説明 | 主なパラメータ |
|---|---|---|
transfer-xrp | アカウントにXRPを送信する | 秘密鍵、宛先、金額、ネットワーク |
get-token-metadata | トークンのメタデータを取得する | トークンアドレス、ネットワーク |
check-token-balance | トークン残高を確認する | トークンアドレス、オーナーアドレス、ネットワーク |
transfer-token | トークンの転送 | 秘密鍵、トークンアドレス、宛先、金額、ネットワーク |
approve-token-spending | トークン支出を承認する | 秘密鍵、トークンアドレス、制限、ネットワーク |
token-clawback | クローバックトークン | 秘密鍵、トークンアドレス、送信元、金額、ネットワーク |
NFTオペレーション
| ツール名 | 説明 | 主なパラメータ |
|---|---|---|
nft-mint | NFTを作成する | 秘密鍵、URI、フラグ、ネットワーク |
get-nft-info | NFTメタデータを取得する | トークンID、ネットワーク |
check-nft-ownership | NFTの所有権を確認する | トークンID、所有者アドレス、ネットワーク |
transfer-nft | NFTを転送する | 秘密鍵、トークンID、ネットワークへ |
get-nft-collection | コレクションでNFTを入手する | アドレス、ネットワーク |
DIDオペレーション
| ツール名 | 説明 | 主なパラメータ |
|---|---|---|
create-did | DIDを作成する | 秘密鍵、データ、ネットワーク |
resolve-did | DIDを解決する | した、ネットワーク |
update-did | DIDを更新する | 秘密鍵、did、データ、ネットワーク |
deactivate-did | DIDを非アクティブ化する | 秘密鍵、did、ネットワーク |
AMMオペレーション
| ツール名 | 説明 | 主なパラメータ |
|---|---|---|
amm-create | AMMを作成する | 秘密鍵、資産、ネットワーク |
amm-deposit | AMMへの入金 | 秘密鍵、ammID、資産、ネットワーク |
amm-bid | AMMに入札する | 秘密鍵、ammID、入札、ネットワーク |
amm-vote | AMMパラメータに投票する | 秘密鍵、ammID、投票、ネットワーク |
amm-delete | AMMを削除する | 秘密鍵、ammID、ネットワーク |
amm-clawback | AMMからの資産の回収 | 秘密鍵、ammID、資産、ネットワーク |
リソース
サーバーは、次の MCP リソース URI を通じて XRPL データを公開します。
元帳リソース
| リソースURIパターン | 説明 |
|---|---|
xrpl://{network}/ledger/current | 現在の元帳情報 |
xrpl://{network}/ledger/{ledger_index} | インデックスによる元帳 |
xrpl://{network}/account/{address} | アカウント情報 |
xrpl://{network}/account/{address}/balance | アカウントXRP残高 |
xrpl://{network}/tx/{tx_hash} | 取引の詳細 |
トークンリソース
| リソースURIパターン | 説明 |
|---|---|
xrpl://{network}/token/{currency}/{issuer} | トークン情報 |
xrpl://{network}/token/{currency}/{issuer}/balanceOf/{address} | トークン残高 |
xrpl://{network}/nft/{tokenID} | NFT情報 |
xrpl://{network}/nft/{tokenID}/owner | NFTの所有権情報 |
🔒 セキュリティに関する考慮事項
- ウォレットシードはトランザクションの署名にのみ使用され、安全に保管する必要があります。
- 本番環境での使用のために追加の認証メカニズムを実装することを検討する
- 高価値サービスの場合は確認手順を追加することを検討してください
- 開発中の安全性を確保するために、TestNetではデフォルトの操作が実行されます。
- 機密性の高い設定には環境変数を使用する
📁 プロジェクト構造
🛠️ 開発
新しいツールの追加
新しいツールを追加するには:
src/transactions/の下の適切なディレクトリに新しい TypeScript ファイルを作成します。server/server.jsからサーバーをインポートします。server.tool()を使用してツールを定義するsrc/index.tsにツールをインポートします。
プロジェクトの依存関係
@modelcontextprotocol/sdk: MCP SDKxrpl: XRP 元帳 JavaScript/TypeScript APIdotenv: 環境変数の管理zod: TypeScriptファーストのスキーマ宣言と検証
📄 ライセンス
このプロジェクトは、MIT ライセンスの条件に基づいてライセンスされます。
⚠️免責事項
このソフトウェアは教育および開発目的のみに提供されています。自己責任でご使用ください。メインネットで実際のXRPを使用する前に、必ずテストネットで十分なテストを行ってください。
This server cannot be installed
XRP Ledgerとの統合を提供するCPサーバー。このサーバーにより、AIアシスタントはXRP Ledger上のアカウント情報、取引履歴、ネットワークデータにアクセスでき、台帳オブジェクトのクエリ、取引の送信、ネットワークの監視などの機能も利用できます。