XRPL MCP Server

XRPL MCP服务器

MCP服务器，为AI助手提供对XRP Ledger数据和网络操作的结构化访问。

需求

• Python 3.10或更新版本

特性

• 获取账户余额和序列号
• 查询信任额度和已发行货币
• 查看帐户拥有的NFT
• 检索账户交易历史记录
• 获取个人交易详细信息
• 检查DEX订单簿报价
• 检索XRPL服务器状态
• 提交已签名的交易

包选择器

选择与您计划使用服务器的方式相匹配的安装目标。

快速入门

下面的快速入门是本地开发和MCP注册的源代码检查路径。如果您只需要已发布的包，请使用上面的PyPI install命令。

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]"

这将以可编辑模式安装软件包，并包括 mcp CLI用于本地开发和Claude Desktop集成。

来自PyPI

发布的包名称与GitHub存储库名称不同。

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

配置

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

• XRPL_NODE_URL：XRP分类账JSON-RPC端点。

违约： https://s1.ripple.com:51234/

安全注意事项

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

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

仅限使用 submit_transaction 当您打算广播一个真实的签名交易时。

为了进行测试，请在启动服务器之前将其指向testnet：

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检查员一起进行本地检查

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

安装到Claude桌面

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分类账账户地址

返回一个结构化对象：

• account
• balance_drops
• balance_xrp
• sequence

get_account_lines

参数：

• address (string)：XRP分类账账户地址
• peer (string，可选）：交易对手帐户筛选器
• limit (integer，可选）：信任线的最大数量

返回XRPL account_lines 结果对象。

get_account_nfts

参数：

• address (string)：XRP分类账账户地址
• limit (integer，可选）：NFT的最大数量

返回XRPL account_nfts 结果对象。

get_account_transactions

参数：

• address (string)：XRP分类账账户地址
• limit (integer，可选）：最大交易次数
• binary (boolean，可选）：以二进制形式返回交易
• forward (boolean，可选）：在分类账历史中向前搜索

返回XRPL account_tx 结果对象。

get_server_info

返回XRPL server_info 结果对象。

submit_transaction

参数：

• tx_blob (string)：十六进制格式的已签名事务blob

返回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

提示：

XRP账户rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe的余额是多少？

结构化结果：

{
  "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许可证