XRPL MCP 服务器

一个模型上下文协议 (MCP) 服务器，为 AI 模型提供对 XRP 分类账本数据和功能的访问。

概述

XRPL MCP 服务器充当大型语言模型 (LLM)（如 Claude 和 GPT）与 XRP 分类账本之间的桥梁。它使 AI 模型能够通过标准化的 API 接口从 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://s1.ripple.com:51234/"）

用法

从源代码运行

启动服务器：

python -m xrpl_mcp_server

作为已安装的软件包运行

xrpl-mcp-server

与 Claude 或其他 MCP 兼容的 AI 助手一起使用

1. 安装 MCP：

   mcp install xrpl-mcp-server
   

2. XRPL 工具将可供 Claude 使用，允许您请求 XRP 分类账本账户信息。

可用工具

get_account_info

检索有关 XRP 分类账本账户的信息。

参数：

• address (字符串)：XRP 分类账本账户地址（以 "r" 开头）

返回：

• 以 XRP 为单位的账户余额
• 账户序列号

get_account_lines

检索 XRP 分类账本账户的信任线。

参数：

• address (字符串)：XRP 分类账本账户地址（以 "r" 开头）
• peer (字符串，可选)：用于过滤结果的交易对手账户地址
• limit (整数，可选)：返回的信任线数量限制

返回：

• 关于账户信任线的 JSON 格式信息

get_account_nfts

检索 XRP 分类账本账户拥有的 NFT。

参数：

• address (字符串)：XRP 分类账本账户地址（以 "r" 开头）
• limit (整数，可选)：返回的 NFT 数量限制

返回：

• 关于账户 NFT 的 JSON 格式信息

get_account_transactions

检索 XRP 分类账本账户的交易历史。

参数：

• address (字符串)：XRP 分类账本账户地址（以 "r" 开头）
• limit (整数，可选)：返回的交易数量限制
• binary (布尔值，可选)：以二进制格式返回交易的标志（默认为 False）
• forward (布尔值，可选)：在账本历史记录中向前搜索的标志（默认为 False）

返回：

• 关于账户交易历史的 JSON 格式信息

get_server_info

检索有关连接的 XRP 分类账本服务器的信息。

参数：

• 无

返回：

• 关于 XRP 分类账本服务器的 JSON 格式信息

submit_transaction

将已签名的交易 blob 提交到 XRP 分类账本。

参数：

• tx_blob (字符串)：十六进制格式的已签名交易 blob

返回：

• JSON 格式的提交结果

get_transaction_info

检索有关特定交易的信息。

参数：

• transaction_hash (字符串)：交易的哈希值

返回：

• JSON 格式的交易详情

get_book_offers

检索 DEX 上货币对的订单簿报价。

参数：

• taker_gets (对象)：交易者想要接收的货币，例如 {"currency": "XRP"} 或 {"currency": "USD", "issuer": "r..."}
• taker_pays (对象)：交易者想要支付的货币，例如 {"currency": "EUR", "issuer": "r..."} 或 {"currency": "XRP"}
• limit (整数，可选)：返回的报价数量限制

返回：

• JSON 格式的订单簿报价

示例

询问 Claude：

XRP 账户 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 的余额是多少？

然后，Claude 可以使用 get_account_info 工具直接从 XRP 分类账本获取此信息。

示例响应：

账户：rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
XRP 余额：25.5
序列：123456

这是另一个例子：

账户 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 拥有哪些 NFT？

Claude 可以使用 get_account_nfts 工具来检索此信息。

开发

有关架构、编码规则和实施计划的详细文档，请参见 memory-bank 目录。

要设置开发环境：

pip install -e ".[dev]"

许可证

MIT 许可证