xrpl-mcp-service

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

  • Provides comprehensive access to the XRP Ledger (XRPL) through various endpoints including account information, decentralized exchange functionality, NFT operations, trust lines & payments, and system operations.

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 - 署名されたトランザクションを送信する

設定

  1. .envファイルを作成します。
XRPL_NODE_URL=https://xrplcluster.com
  1. 依存関係をインストールします:
pip install xrpl-py fastapi uvicorn python-dotenv
  1. サーバーを実行します。
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. プルリクエストを送信する

重要な注意事項

  • 生産時には常に「検証済み」の台帳を使用する
  • 安全なウォレットシードと秘密鍵
  • 取引手数料を監視する
  • まずはテストネットで徹底的にテストする

リソース

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

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

  1. Features
    1. Account Information
    2. Decentralized Exchange
    3. NFT Operations
    4. Trust Lines & Payments
    5. System
  2. Setup
    1. API Usage Examples
      1. Get Account Info
      2. Get Account Balances
      3. Set Trust Line
      4. Get AMM Info
      5. Get Market Price
    2. Project Structure
      1. Key Components
        1. Future Enhancements
          1. Common Issues
            1. Contributing
              1. Important Notes
                1. Resources
                  1. License
                    ID: qh6y5cvx2o