mcp-xrpl 是一个面向 XRP Ledger 生态系统的 Model Context Protocol（MCP）服务器，旨在让 AI 智能体能够与 XRP Ledger 区块链进行交互。它通过统一的接口暴露 XRPL 的多种功能，使 AI 智能体可以方便地发现和使用这些服务。
用途
该服务器的主要用途是为 AI 智能体提供访问 XRP Ledger 的能力，支持读取账本状态、执行交易、管理资产等操作。它适用于需要与 XRP Ledger 交互的 AI 应用场景，例如自动化交易、资产管理、区块链数据查询等。
主要能力
服务器支持以下功能类别：
- 账户管理：连接 XRPL 网络（MainNet、TestNet、DevNet）、获取账户信息、管理账户属性、存款预授权、常规密钥管理。
- XRP 与代币操作：在账户间转移 XRP、获取代币元数据（名称、符号、小数位、供应量）、检查代币余额、转移代币、批准代币支出。
- NFT 操作：在 XRP Ledger 上铸造 NFT、查看 NFT 元数据、验证 NFT 所有权、转移 NFT、获取 NFT 集合。
- 去中心化标识符（DID）：创建 DID、更新 DID 文档、停用 DID。
- 自动做市商（AMM）：创建 AMM、向 AMM 存款、在 AMM 上出价、对 AMM 参数投票、从 AMM 中回收资产。
- 支票操作、去中心化交易所（DEX）操作、预言机操作（设置和删除预言机数据）、支付通道（创建、注资、领取）、信任线管理、创建票据用于交易处理。
所有服务均通过一致的 MCP 工具和资源接口暴露，便于 AI 智能体集成。
使用方式
使用前需要满足以下前提条件：Node.js 18.0.0 或更高版本。 配置：在项目根目录创建 .env 文件，设置必要的环境变量（具体变量未在资料中列出）。 启动服务器：资料中未提供具体启动命令。 连接服务器：使用任何兼容 MCP 的客户端连接此 MCP 服务器。测试和调试可使用 MCP Inspector。
适用场景
适用于需要 AI 智能体与 XRP Ledger 交互的开发场景，例如构建自动化交易机器人、资产管理工具、区块链数据分析应用等。默认操作在 TestNet 上执行，以确保开发安全。
限制与安全考虑
- 钱包种子仅用于交易签名，应妥善保管。
- 生产环境建议实施额外的身份验证机制。
- 对于高价值服务，建议添加确认步骤。
- 默认操作在 TestNet 上执行。
- 敏感配置应使用环境变量。
- 该软件仅供教育和开发目的使用，使用风险自负。在 MainNet 上使用真实 XRP 之前，务必在 Testnet 上充分测试。
项目结构
项目使用 TypeScript 编写，依赖包括 @modelcontextprotocol/sdk、xrpl、dotenv 和 zod。添加新工具时，需在 src/transactions/ 下创建 TypeScript 文件，导入 server/server.js，使用 server.tool() 定义工具，并在 src/index.ts 中导入。
许可证：MIT。
