XRPL MCP サービス

XRP Ledger（XRPL）への包括的なアクセスを提供するModel Context Protocol（MCP）サーバー。このサービスにより、AIモデルは標準化されたエンドポイントを介してXRPLと連携できるようになります。

特徴

アカウント情報

• xrpl_account_info - 基本的なアカウントの詳細

• xrpl_account_balances - XRPとトークンの残高（人間が読める形式）

• xrpl_account_lines - 信頼ライン

• xrpl_account_offers - アクティブな取引オファー

• xrpl_account_nfts - NFT保有量

• xrpl_account_tx - 取引履歴

分散型取引所

• xrpl_order_book - 通貨ペアの注文書を表示する

• xrpl_market_price - 現在の市場価格を取得する

• xrpl_amm_info - 自動マーケットメーカー情報

NFTオペレーション

• xrpl_nft_offers - NFTの売買オファーを表示

信頼ラインと支払い

• xrpl_set_trust_line - 新しい信頼ラインを確立する

• xrpl_remove_trust_line - 既存の信頼ラインを削除する

• xrpl_payment_channels - 支払いチャネル情報

• xrpl_find_path - 支払いパスの検索

• xrpl_deposit_auth - 支払い承認を確認する

システム

• xrpl_server_info - ノードのステータスと情報

• xrpl_submit_tx - 署名されたトランザクションを送信する

Related MCP server: Flow MCP Server

設定

1. .envファイルを作成します。

XRPL_NODE_URL=https://xrplcluster.com

2. 依存関係をインストールします:

pip install xrpl-py fastapi uvicorn python-dotenv

3. サーバーを実行します。

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

APIの使用例

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

POST /call-tool/xrpl_account_info
{
  "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}

アカウント残高を取得する

POST /call-tool/xrpl_account_balances
{
  "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}

信頼ラインを設定する

POST /call-tool/xrpl_set_trust_line
{
  "wallet_seed": "sXXXXXXXXXXXXXXXXXXXX",
  "currency": "USD",
  "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "limit": "1000"
}

AMM情報を取得する

POST /call-tool/xrpl_amm_info
{
  "asset": {
    "currency": "XRP"
  },
  "asset2": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  }
}

市場価格を取得する

POST /call-tool/xrpl_market_price
{
  "base_currency": {
    "currency": "XRP"
  },
  "quote_currency": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  }
}

プロジェクト構造

├── main.py              # FastAPI application entry point
├── tools/
│   ├── __init__.py
│   ├── register_tools.py # Tool registration
│   └── xrpl_tools.py    # XRPL endpoint implementations

主要コンポーネント

1. xrpl_tools.py

   • コアXRPLインタラクション関数

   • イベントループ処理による非同期実装

   • エラー処理とレスポンスのフォーマット

2. レジスタツール.py

   • MCPツール登録

   • エンドポイントのマッピングと構成

将来の機能強化

1. AMM（流動性プール）運用

   • プールを作成する

   • 流動性の追加/削除

   • プールパラメータに投票する

2. 高度な取引

   • オファーの作成/キャンセル

   • 自動取引機能

   • 価格アラート

3. NFTオペレーション

   • ミントNFT

   • オファーの作成/承認

   • コレクション管理

よくある問題

1. 非同期イベントループ: 「asyncio.run() は実行中のイベントループから呼び出すことができません」と表示される場合は、xrpl_tools.py の非同期実装を確認してください。

2. レート制限: 本番環境での使用にはレート制限の実装を検討してください

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更を実装する

4. プルリクエストを送信する

重要な注意事項

• 生産時には常に「検証済み」の台帳を使用する

• 安全なウォレットシードと秘密鍵

• 取引手数料を監視する

• まずはテストネットで徹底的にテストする

リソース

• XRPLドキュメント

• MCP プロトコル ドキュメント

• FastAPIドキュメント

ライセンス

マサチューセッツ工科大学