XRPL MCP Server

XRPL MCP 服务器

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

概述

XRPL MCP 服务器充当 Claude 和 GPT 等大型语言模型 (LLM) 与 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 # On Windows: venv\Scripts\activate
3. 安装依赖项：
   pip install -r requirements.txt

使用 pip

配置

服务器使用以下环境变量：

• XRPL_NODE_URL - XRP 账本节点 URL（默认为“ https://s1.ripple.com:51234/ ”）

用法

从源运行

启动服务器：

作为已安装包运行

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

1. 安装 MCP：
   mcp install xrpl-mcp-server
2. XRPL 工具将提供给 Claude，允许您索取 XRP 分类账帐户信息。

可用工具

获取账户信息

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

参数：

• address （字符串）：XRP 账本账户地址（以“r”开头）

返回：

• XRP 账户余额
• 账户序列号

获取账户明细

检索 XRP 分类帐帐户的信任线。

参数：

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

返回：

• 有关帐户信任线的 JSON 格式信息

获取账户信息

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

参数：

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

返回：

• 有关帐户 NFT 的 JSON 格式信息

获取账户交易

检索 XRP 分类帐帐户的交易历史记录。

参数：

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

返回：

• 有关帐户交易历史记录的 JSON 格式信息

获取服务器信息

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

参数：

• 没有任何

返回：

• 有关 XRP 账本服务器的 JSON 格式信息

提交交易

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

参数：

• tx_blob （字符串）：十六进制格式的签名交易 blob

返回：

• JSON格式的提交结果

获取交易信息

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

参数：

• transaction_hash （字符串）：交易的哈希值

返回：

• JSON格式的交易详情

获取书籍优惠

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

参数：

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

返回：

• JSON 格式的订单簿报价

示例

问克劳德：

XRP账户rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe的余额是多少？

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

响应示例：

这是另一个例子：

账户 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 拥有哪些 NFT？

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

发展

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

设置开发环境：

执照

MIT 许可证