内容
# XRPL MCP 服务
[](https://smithery.ai/server/@tedlikeskix/xrpl-mcp-service)
一个提供全面访问 XRP Ledger (XRPL) 功能的模型上下文协议（MCP）服务器。该服务使 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` - 自动做市商（AMM）信息
### 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` 文件：
```env
XRPL_NODE_URL=https://xrplcluster.com
```
2. 安装依赖：
```bash
pip install xrpl-py fastapi uvicorn python-dotenv
```
3. 运行服务器：
```bash
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```
## API 使用示例
### 获取账户信息
```json
POST /call-tool/xrpl_account_info
{
"account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}
```
### 获取账户余额
```json
POST /call-tool/xrpl_account_balances
{
"account": "rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z"
}
```
### 设置信任线
```json
POST /call-tool/xrpl_set_trust_line
{
"wallet_seed": "sXXXXXXXXXXXXXXXXXXXX",
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"limit": "1000"
}
```
### 获取 AMM 信息
```json
POST /call-tool/xrpl_amm_info
{
"asset": {
"currency": "XRP"
},
"asset2": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
}
}
```
### 获取市场价格
```json
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. 分叉仓库
2. 创建功能分支
3. 实现更改
4. 提交拉取请求
## 重要注意事项
- 始终为生产环境使用“validated”账本
- 保护钱包种子和私钥
- 监控交易费用
- 先在测试网中进行彻底测试
## 资源
- [XRPL 文档](https://xrpl.org/docs.html)
- [MCP 协议文档](https://docs.anthropic.com/claude/docs/model-context-protocol)
- [FastAPI 文档](https://fastapi.tiangolo.com/)
## 许可证
MIT
MCP 市场