Xrpl MCP Service

🚀 XRPL MCP 服務

一個 Model Context Protocol (MCP) 服務器，提供對 XRP Ledger (XRPL) 的全面訪問。此服務使 AI 模型能夠通過標準化端點與 XRPL 進行交互，極大地提升了 AI 與區塊鏈交互的便利性和效率。

🚀 快速開始

要使用本服務，你需要完成以下幾個步驟：

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

✨ 主要特性

賬戶信息

• 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 許可證。