XRPL MCP 服务器

一个模型上下文协议（MCP）服务器，提供AI模型访问XRP账本数据和功能的能力。

概述

XRPL MCP 服务器作为大型语言模型（如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：

账户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许可证