XRPL MCP Service

基本能力

产品定位

XRPL MCP Service 是一个基于模型上下文协议（MCP）的服务，提供对 XRP Ledger（XRPL）的全面访问。该服务使 AI 模型能够通过标准化端点与 XRPL 进行交互。

核心功能

• 账户信息：包括基本账户详情、XRP 和代币余额、信任线、活跃交易报价、NFT 持有情况和交易历史。
• 去中心化交易所：查看货币对的订单簿、获取当前市场价格、自动做市商信息。
• NFT 操作：查看 NFT 买卖报价。
• 信任线 & 支付：建立和移除信任线、支付通道信息、支付路径查找、检查支付授权。
• 系统：节点状态和信息、提交签名交易。

适用场景

• 需要与 XRP Ledger 集成的金融应用。
• 交易平台和 NFT 市场。
• 需要查询和管理 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：获取自动做市商信息。
• 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. Async Event Loop：如果看到 "asyncio.run() cannot be called from a running event loop"，请检查 xrpl_tools.py 中的异步实现。
2. Rate Limiting：考虑为生产使用实施速率限制。

使用教程

使用依赖

1. 创建 .env 文件：

XRPL_NODE_URL=https://xrplcluster.com

1. 安装依赖：

pip install xrpl-py fastapi uvicorn python-dotenv

安装教程

1. 运行服务器：

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

调试方式

1. 使用 API 示例进行调试，例如获取账户信息：

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

1. 获取账户余额：

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

1. 设置信任线：

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

1. 获取 AMM 信息：

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

1. 获取市场价格：

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

许可证

该项目遵循 MIT 开源许可条款。