Xrpl MCP Service

🚀 XRPL MCP サービス

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

🚀 クイックスタート

XRPL MCP サービスを使用することで、AI モデルが XRPL と容易にやり取りできるようになります。以下のセクションでは、サービスの機能、設定方法、API の使用例などを説明します。

✨ 主な機能

アカウント情報

• 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

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

pip install xrpl-py fastapi uvicorn python-dotenv

3. サーバーを起動します：

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

💻 使用例

アカウント情報の取得

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

アカウント残高の取得

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

信頼線の設定

POST /call-tool/xrpl_set_trust_line
{
  "account": "alice",
  "trustee": "bob",
  "amount": "100"
}

オーダーブックの取得

POST /call-tool/xrpl_order_book
{
  "order_id": "12345"
}

📚 ドキュメント

プロジェクト構造

• main.py - FastAPI アプリケーションのエントリーポイント
• xrpl_tools.py - XRPL ツールと関数
• templates/ - HTML テンプレートファイル
• static/ - 静的リソースファイル

主要コンポーネント

• XrplClient - XRPL ネットワークとの相互作用に使用するクライアントクラス
• TrustLineManager - 信頼線操作を処理するマネージャー
• PaymentChannel - 支払いチャネル機能をサポートするクラス
• OrderBook - オーダーブックのデータ構造を実装するクラス

将来的な機能強化計画

1. ウォレット統合：複数のウォレットプロバイダーのサポートを追加
2. トランザクション監視：トランザクションのリアルタイム更新通知を実装
3. API ドキュメント：インタラクティブな API ドキュメントを生成
4. パフォーマンス最適化：大量のリクエストの処理能力を向上

貢献ガイドライン

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を実装する
4. プルリクエストを送信する

🔧 技術詳細

重要な注意事項

⚠️ 重要提示

• 本番環境では常に「検証済み」のブロックチェーンを使用してください。
• ウォレットのシードと秘密鍵を安全に保管してください。
• 取引手数料を監視してください。
• テストネットで十分なテストを行ってください。

リソース

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

📄 ライセンス

MIT