XRPL MCP Server

XRPL MCP 服务

一个 MCP 服务，可让 AI 助手以结构化方式访问 XRP Ledger 数据并执行网络操作。

要求

• Python 3.10 或更高版本

功能

• 获取账户余额和序列号
• 查询信任线和已发行货币
• 查看账户持有的 NFT
• 获取账户交易历史记录
• 获取单笔交易详情
• 检查 DEX 订单簿报价
• 获取 XRPL 服务状态
• 提交已签名的交易

软件包选择

根据计划使用服务的方式，选择对应的安装目标。

软件包	PyPI	安装	适用场景
已发布的软件包		python -m pip install iflow-mcp_lgcarrier-xrpl-mcp-server	如果你希望立即使用打包好的 CLI／服务，且不需要可编辑的代码检出版本，推荐使用此方式。
源码检出版本	—	python -m pip install -e ".[dev]"	如果你要在此仓库中开发、运行测试，或使用下文介绍的本地 mcp dev／mcp install 工作流，请选择此方式。

快速入门

以下快速入门介绍的是用于本地开发和注册 MCP 的源码检出方式。如果你只需要已发布的软件包，请使用上方的 PyPI 安装命令。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

mcp install src/xrpl_mcp_server/server.py:mcp --with-editable .

可以尝试的第一个提示词：

账户 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 的 XRP 余额和序列号是多少？

安装

从源码安装

git clone https://github.com/lgcarrier/xrpl-mcp-server.git
cd xrpl-mcp-server
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

此操作会以可编辑模式安装软件包，并包含用于本地开发和 Claude Desktop 集成的 mcp CLI。

从 PyPI 安装

已发布的软件包名称与 GitHub 仓库名称不同。

python -m pip install iflow-mcp_lgcarrier-xrpl-mcp-server

配置

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

• XRPL_NODE_URL：XRP Ledger JSON-RPC 端点。 默认值：https://s1.ripple.com:51234/

安全提示

默认情况下，此服务会连接到 Ripple 的公共主网端点。这意味着：

• 只读工具会查询实时主网数据
• submit_transaction 会将已签名的交易提交到实时 XRP Ledger 网络

仅当你确定要广播真实的已签名交易时，才使用 submit_transaction。

如需测试，请在启动服务前将其指向测试网：

export XRPL_NODE_URL="https://s.altnet.rippletest.net:51234/"
python -m xrpl_mcp_server

你也可以在设置环境变量后安装 Claude Desktop 配置项：

mcp install src/xrpl_mcp_server/server.py:mcp --with-editable . \
  --env-var XRPL_NODE_URL=https://s.altnet.rippletest.net:51234/

使用方法

直接从源码运行

python -m xrpl_mcp_server

作为已安装的软件包运行

xrpl-mcp-server

使用 MCP Inspector 在本地检查

mcp dev src/xrpl_mcp_server/server.py:mcp --with-editable .

安装到 Claude Desktop

mcp install src/xrpl_mcp_server/server.py:mcp --with-editable .

如果你更喜欢使用 uv，对应的命令为 uv run mcp dev ... 和 uv run mcp install ...。

可用工具

所有工具均保留原有名称和参数。调用成功时会返回结构化 MCP 输出，而不是纯文本或 JSON 编码字符串。

get_account_info

参数：

• address（string）：XRP Ledger 账户地址

返回包含以下字段的结构化对象：

• account
• balance_drops
• balance_xrp
• sequence

get_account_lines

参数：

• address（string）：XRP Ledger 账户地址
• peer（string，可选）：交易对手账户筛选条件
• limit（integer，可选）：信任线的最大数量

返回 XRPL account_lines 结果对象。

get_account_nfts

参数：

• address（string）：XRP Ledger 账户地址
• limit（integer，可选）：NFT 的最大数量

返回 XRPL account_nfts 结果对象。

get_account_transactions

参数：

• address（string）：XRP Ledger 账户地址
• limit（integer，可选）：交易的最大数量
• binary（boolean，可选）：以二进制形式返回交易
• forward（boolean，可选）：向前搜索账本历史记录

返回 XRPL account_tx 结果对象。

get_server_info

返回 XRPL server_info 结果对象。

submit_transaction

参数：

• tx_blob（string）：十六进制格式的已签名交易数据

返回 XRPL submit 结果对象。

get_transaction_info

参数：

• transaction_hash（string）：交易哈希

返回 XRPL tx 结果对象。

get_book_offers

参数：

• taker_gets（object）：交易方希望收到的货币/发行方对象
• taker_pays（object）：交易方希望支付的货币/发行方对象
• limit（integer，可选）：报价数量上限

返回 XRPL book_offers 结果对象。

错误

工具失败时会以 MCP 工具错误的形式返回，而不是成功负载。常见情况包括：

• 查询缺失地址的账户，例如 actNotFound
• 查询未知哈希的交易，例如 txnNotFound
• 上游 XRPL 请求失败，包括提交错误和传输异常

未找到错误示例：

Account rMissingExampleAddress not found on the ledger.

提交错误示例：

Submitting transaction failed: tefFAILURE: submission rejected

示例

get_account_info

提示词：

rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 这个 XRP 账户的余额是多少？

结构化结果：

{
  "account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
  "balance_drops": "25500000",
  "balance_xrp": "25.5",
  "sequence": 123456
}

get_account_transactions

提示词：

显示 rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe 最近的两笔交易。

代表性结果形态：

{
  "account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
  "ledger_index_max": 98765432,
  "ledger_index_min": 98765400,
  "transactions": [
    {
      "tx": {
        "hash": "ABC123...",
        "TransactionType": "Payment"
      },
      "validated": true
    },
    {
      "tx": {
        "hash": "DEF456...",
        "TransactionType": "TrustSet"
      },
      "validated": true
    }
  ]
}

get_book_offers

提示词：

显示 XRPL DEX 上 XRP/USD 的前三个报价。

代表性结果形态：

{
  "ledger_current_index": 98765432,
  "offers": [
    {
      "Account": "rOfferMaker1",
      "Sequence": 100,
      "quality": "0.5"
    },
    {
      "Account": "rOfferMaker2",
      "Sequence": 101,
      "quality": "0.51"
    }
  ]
}

开发

运行测试套件：

pytest

许可证

MIT 许可证