XRPL MCP 服务

一个模型上下文协议 (MCP) 服务器，提供对 XRP 分类账 (XRPL) 的全面访问。此服务使 AI 模型能够通过标准化端点与 XRPL 交互。

功能

账户信息

• xrpl_account_info - 基本账户详细信息
• xrpl_account_balances - XRP 和代币余额（人类可读）
• xrpl_account_lines - 信任线
• xrpl_account_offers - 活动交易报价
• xrpl_account_nfts - NFT 持有量
• xrpl_account_tx - 交易历史

去中心化交易所

• xrpl_order_book - 查看货币对的订单簿
• xrpl_market_price - 获取当前市场价格
• xrpl_amm_info - 自动做市商信息

NFT 操作

• xrpl_nft_offers - 查看 NFT 买/卖报价

信任线 & 支付

• xrpl_set_trust_line - 建立新的信任线
• xrpl_remove_trust_line - 移除现有的信任线
• xrpl_payment_channels - 支付通道信息
• xrpl_find_path - 支付路径查找
• xrpl_deposit_auth - 检查支付授权

系统

• xrpl_server_info - 节点状态和信息
• xrpl_submit_tx - 提交已签名交易

设置

1. 创建一个 .env 文件:

XRPL_NODE_URL=https://xrplcluster.com

2. 安装依赖:

pip install xrpl-py fastapi uvicorn python-dotenv

3. 运行服务器:

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

API 使用示例

获取账户信息

POST /call-tool/xrpl_account_info
{
  "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}

获取账户余额

POST /call-tool/xrpl_account_balances
{
  "account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}

设置信任线

POST /call-tool/xrpl_set_trust_line
{
  "wallet_seed": "sXXXXXXXXXXXXXXXXXXXX",
  "currency": "USD",
  "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "limit": "1000"
}

获取 AMM 信息

POST /call-tool/xrpl_amm_info
{
  "asset": {
    "currency": "XRP"
  },
  "asset2": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  }
}

获取市场价格

POST /call-tool/xrpl_market_price
{
  "base_currency": {
    "currency": "XRP"
  },
  "quote_currency": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  }
}

项目结构

├── main.py              # FastAPI 应用程序入口点
├── tools/
│   ├── __init__.py
│   ├── register_tools.py # 工具注册
│   └── xrpl_tools.py    # XRPL 端点实现

关键组件

1. xrpl_tools.py

   • 核心 XRPL 交互函数
   • 具有事件循环处理的异步实现
   • 错误处理和响应格式化

2. register_tools.py

   • MCP 工具注册
   • 端点映射和配置

未来增强

1. AMM（流动性池）操作

   • 创建池
   • 添加/移除流动性
   • 投票决定池参数

2. 高级交易

   • 创建/取消报价
   • 自动交易功能
   • 价格提醒

3. NFT 操作

   • 铸造 NFT
   • 创建/接受报价
   • 集合管理

常见问题

1. 异步事件循环: 如果您看到 "asyncio.run() cannot be called from a running event loop"，请检查 xrpl_tools.py 中的异步实现

2. 速率限制: 考虑为生产环境实施速率限制

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 实现您的更改
4. 提交一个 pull request

重要提示

• 始终使用 "validated" 分类账进行生产
• 保护钱包种子和私钥
• 监控交易费用
• 首先在测试网上彻底测试

资源

• XRPL 文档
• MCP 协议文档
• FastAPI 文档

许可证

MIT