@florent-uzio/xrpl-mcp

中文文档
2.0.1发布于 2026/11/11MITES Module零依赖构建来源已验证近 30 天下载 2231

MCP 服务器曝光 XRP Ledger 工具和符号发布工作流程

中文使用文档
文档目录5 节
  1. 用克劳德代码的
  2. 网络和秘密
  3. 工作流量
  4. 添加工具
  5. 发展

缩写

一个MCP服务器, @florent-uzio/xrpl-mcp,这样可以让一个AI客户端,如克洛德代码查询和在XRP Ledger上进行交易. 它运行在 Stdio 并且与 马斯特拉 财务报告和审定财务报表 页:1。见 GLOSSARY.md 用于词汇.

  • 120多个工具数字 :
    • 查询分类账(账户、分类账、交易、订单簿、AMM、NFT、金库、服务器、收费)
    • 提交XRPL交易类型(付款、信托、DEX报价、AMM、NFT、MPT、代管、支票、支付渠道、证书、金库、出借、甲骨文、批发、保密的MPT)
    • 创建和资助钱包
    • 转换单位和货币代码
  • 4个工作流程 用于测试网络的多步骤设置:IOU发行,MPT发行,保密的MPT和出借设置.

用克劳德代码的

你只需要22.13节节点 不需要模型 API 键: Claude Code 进行推理并调用工具.

claude mcp add xrpl -- npx -y @florent-uzio/xrpl-mcp@latest

然后问克洛德诸如"主网上rXXX的平衡是什么"或"测试网上是否有有2个持有人的MPT"等.

@latest 制造 npx 检查 npm 每次 Claude Code 启动服务器, 因此在您的下个会话中, 或在您重新连接时, 都会有新的释放负载 xrpl 从 /mcp。要保持一个版本,就把它固定起来,例如. @florent-uzio/[email protected]。 。 。 .

要从此 repo 的克隆运行服务器 :

claude mcp add xrpl -- npm --prefix "$(pwd)" run --silent mcp

网络和秘密

  • 主网为默认. 说"testnet"或"devnet",或给一个 wss:// URL,用于使用另一个网络. 每个已知的网络都列在 src/helpers/networks.ts。 。 。 .
  • 种子在测试网络外被拒绝,在连接之前。 在主网上,你自己在交易上签名,并提交blob submitSignedBlob。 。 。 .
  • 流动记录 保留会话所创建的内容(钱包,MPT ID,密钥,散列),所以后会话可以再用. saveFlowRecord 主网拒绝种子和私钥.
变量目的
XRPL_RECORDS_DIR流程记录文件夹 。 默认为 ~/.xrpl-mcp/records。 。 。 .
XRPL_EXTRA_TEST_NETWORKS允许种子的其他测试网络的逗号分隔的URL,例如本地节点. 传递给 MCP 服务器 claude mcp add xrpl --env XRPL_EXTRA_TEST_NETWORKS=ws://localhost:6006 -- npx -y @florent-uzio/xrpl-mcp@latest。 。 。 .

工作流量

服务器将每个工作流程曝光为 run_<name>。 。 。 .

工作流程网络它会做什么
iou-issuance测试网, devnet为发行人和持有者提供资金,配置发行人,创建信托行并给每个持有者发出信使.
mpt-issuance测试网, devnet为发行人和持有者提供资金,创建MPT发行(旗子,分级,元数据),选择持有者进入并发给他们信使.
confidential-mpt脱网创建或再利用一个保密的MPT,注册ElGamal密钥,将持有人余额转换为机密,然后可选择发送并转换回.
lending-setup脱网创建可转移的MPT,封闭式金库,存款,出借经纪人及其一败涂地. 贷款本身随后与 signLoanSet。 。 。 .

每一工作流程的输入情况均载于其计划,如: src/workflows/*.types.ts。 。 。 .

添加工具

交易工具使用工厂. 它又说 network 财务报告和审定财务报表 seed,拒绝测试网络外的种子,六进制编码每个货币代码,然后自动填充,签名并提交交易:

// src/tools/transactions/payment/payment.ts
import { Payment } from 'xrpl'
import { useTransactionToolFactory } from '../factory'
import { xrplPaymentSchema } from './payment.types'

const { createTransactionTool } = useTransactionToolFactory({ inputSchema: xrplPaymentSchema })

export const submitPaymentTool = createTransactionTool<Payment>({
  toolId: 'submitPayment',
  description: 'Submit a Payment transaction to send XRP, tokens or MPTs. ...',
  // Optional: reshape the input into the transaction
  buildTransaction: payment => ({ ...payment, Amount: payment.DeliverMax ? undefined : payment.Amount }) as Payment,
  // Optional: throw to refuse the transaction before it is signed
  validateTransaction: params => {
    if (params.Amount === undefined && params.DeliverMax === undefined) {
      throw new Error('Provide Amount (API v1) or DeliverMax (API v2)')
    }
  },
})

使用查询工具 defineMethodTool (单位:千美元)src/tools/methods/shared/method-tool.ts),与 id, xrpld 键 command 编辑 request 财务报告和审定财务报表 result 计划.

从文件夹中导出新工具 index.ts。 。 。 . src/catalog.ts 拾取每个导出的工具 src/tools,所以服务器会将其曝光.

服务器将每个工具暴露在其id下,因此id是模型所看到的名称. 以 id 命名导出 Tool 后缀 (submitPaymentTool 页:1 submitPayment测试一下 永远不要重命名一个已出版的工具: 它会打破每个调用它的客户端( 见 docs/adr/0001-tool-names-are-camelcase-ids.md) (中文(简体) ).

发展

npm test               # unit tests
npm run typecheck      # tsc
npm run format         # prettier
npm run build          # bundle the server into dist/

域名术语为 格洛萨里·姆德。随后发布MCP软件包 相关内容。 。 。 .

版本与发布记录

@florent-uzio/xrpl-mcp 共发布 11 个版本,首次发布于 2026/10/26;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.1latest2026/11/114 天前
2.0.02026/11/114 天前
1.3.12026/11/114 天前
1.3.02026/11/0312 天前
1.2.12026/11/0213 天前
1.2.02026/11/0213 天前

关于 @florent-uzio/xrpl-mcp 的常见问题

@florent-uzio/xrpl-mcp 是什么?

MCP 服务器曝光 XRP Ledger 工具和符号发布工作流程

如何安装 @florent-uzio/xrpl-mcp?

在项目目录运行 npm install @florent-uzio/xrpl-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 xrpl-mcp,可以用 npx xrpl-mcp 直接运行。

@florent-uzio/xrpl-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/florent-uzio__xrpl-mcp 是否存在。

@florent-uzio/xrpl-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@florent-uzio/xrpl-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@florent-uzio/xrpl-mcp 可以商用吗?

@florent-uzio/xrpl-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@florent-uzio/xrpl-mcp 的下载量有多少?

根据 npm 官方下载统计,@florent-uzio/xrpl-mcp 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,231 次,日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@florent-uzio/xrpl-mcp 还在维护吗?

最新版本 2.0.1 发布于 2026/11/11(4 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。