Xrpl MCP Server

🚀 XRPL MCP 服務器

XRPL MCP 服務器是一個基於模型上下文協議 (MCP) 的服務器，它為 AI 模型提供了訪問 XRP 賬本數據和功能的途徑，有效搭建起 AI 與 XRP 賬本之間的溝通橋樑。

🚀 快速開始

XRPL MCP 服務器是大型語言模型（如 Claude 和 GPT）與 XRP 賬本之間的橋樑，藉助標準化 API 接口，AI 模型能夠從 XRP 賬本檢索賬戶信息。

✨ 主要特性

• 獲取賬戶信息（餘額、序列號）
• 查詢信任線和發行的貨幣
• 查看賬戶擁有的 NFT
• 檢索交易歷史
• 訪問 DEX 的訂單簿數據
• 提交簽名事務到網絡
• 獲取服務器狀態信息
• 通過 MCP 可靠訪問 XRP 賬本數據
• 方便與 MCP 兼容的 AI 應用程序集成

📦 安裝指南

從源代碼安裝

1. 克隆此倉庫：

   git clone https://github.com/lgcarrier/xrpl-mcp-server.git
   cd xrpl-mcp-server
   

2. 創建並激活虛擬環境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

使用 pip 安裝

pip install xrpl-mcp-server

📚 詳細文檔

配置

服務器使用以下環境變量：

• XRPL_NODE_URL - XRP 賬本節點的 URL（默認為 https://xrpl.xrpspaces.com）

使用方法

從源代碼運行

1. 啟動 MCP 代理：

   python -m xrpl_mcp_agent
   

2. 在 Claude 中配置 MCP 客戶端，使用代理地址：

from xrpl_mcp_client import McpClient

client = McpClient("http://localhost:5000")

作為已安裝包運行

1. 啟動 MCP 代理：

   xrpl-mcp-agent
   

2. 在 Claude 中配置 MCP 客戶端，使用代理地址：

from xrpl_mcp_client import McpClient

client = McpClient("http://localhost:5000")

💻 使用示例

基礎用法

詢問 Claude：

請問賬戶 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 的 XRP 平衡是多少？

Claude 可以使用 get_account_info 工具直接從 XRP 賬本獲取此信息。

示例響應：

賬戶：rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
XRP 餘額：25.5
序列號：123456

高級用法

詢問：

賬戶 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 擁有哪些 NFT？

Claude 可以使用 get_account_nfts 工具來檢索此信息。

🔧 技術細節

參見 memory-bank 目錄下的文檔，瞭解有關架構、編碼規則和實現計劃的詳細信息。

設置開發環境：

pip install -e ".[dev]"

📄 許可證

本項目採用 MIT 許可證。