项目简介
RGB MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在将比特币上RGB智能合约的功能扩展到AI助手。它集成了RGB资产管理、点对点信任链(Trustlines)、支付通道以及RGB与XRPL(XRP Ledger)之间的跨链桥接功能。通过该服务器,AI助手能够以标准化的方式访问并操作复杂的区块链生态系统。
主要功能点
- RGB智能合约管理: 实现比特币/闪电网络上RGB资产的发行、转移和验证,支持RGB20、RGB21、RGB25等多种合约类型。
- 信任链协议 (Trustlines): 建立和管理两个参与者之间的双边信用额度,支持无需即时资产移动的链下信用转移,并在需要时进行链上结算。
- 支付通道: 提供双向支付通道,用于RGB资产的链下、近乎即时的转移,减少链上费用。
- XRPL跨链桥接: 允许在RGB和XRPL之间进行资产交换。该桥接采用流动性池和信任链模型,桥接操作员作为市场做市商,确保1:1的资产支持,而非凭空铸造代币。
- XRPL集成: 提供XRPL账户创建、信任线设置等基本操作,以支持桥接后的XRPL资产交互。
- Contractum支持: 提供Contractum智能合约语言的编译、验证、部署及模板生成工具。
安装步骤
-
克隆仓库:
git clone https://github.com/Quigles1337/RGB-MCP-SERVERv1.git cd RGB-MCP-SERVERv1注意:虽然仓库URL包含'v2',但项目内容和代码声明的版本为'v1',请以实际克隆的'RGB-MCP-SERVERv1'目录为准。
-
安装依赖:
npm install -
构建项目:
npm run build或在开发模式下运行(支持文件热重载):
npm run dev -
环境配置: 在项目根目录创建 '.env' 文件,根据您的需求配置RGB节点、Bitcoin节点、XRPL节点等的连接信息,以及桥接、信任链和支付通道的启用状态和参数。您可以参考项目提供的 '.env.example' 文件。
# 示例 .env 配置 (请根据您的实际环境进行修改) # RGB 配置 RGB_NETWORK=testnet RGB_NODE_URL=http://localhost:3000 # Bitcoin 配置 BITCOIN_NETWORK=testnet BITCOIN_RPC_URL=http://localhost:18332 BITCOIN_RPC_USER=user BITCOIN_RPC_PASSWORD=password # XRPL 配置 XRPL_NETWORK=testnet XRPL_NODE_URL=wss://s.altnet.rippletest.net:51233 # 桥接功能配置 BRIDGE_ENABLED=true BRIDGE_FEE_PERCENT=0.3 BRIDGE_MIN_AMOUNT=10 BRIDGE_MAX_AMOUNT=100000 # 信任链功能配置 TRUSTLINES_ENABLED=true TRUSTLINES_DEFAULT_LIMIT=1000000 # 支付通道功能配置 PAYCHAN_ENABLED=true PAYCHAN_EXPIRY_BLOCKS=1440 PAYCHAN_MIN_DEPOSIT=1000 # MCP 服务器日志级别 (可选: debug, info, warn, error) MCP_LOG_LEVEL=info
服务器配置(供MCP客户端使用)
MCP客户端(如Cursor IDE或Claude Desktop)需要配置本MCP服务器的启动命令,以便建立连接并调用其提供的工具。以下是配置示例:
- 服务器名称 (name): 'rgb-mcp-server'
- 启动命令 (command): 'node'
- 命令参数 (args): '["C:/Users/YourName/RGB-MCP-SERVERv1/dist/server.js"]' (请将 'C:/Users/YourName/RGB-MCP-SERVERv1' 替换为您的实际安装路径)
- 环境变量 (env, 可选): 根据需要设置,以覆盖 '.env' 文件中的部分配置,例如:
{ "RGB_NETWORK": "testnet", "XRPL_NETWORK": "testnet", "BRIDGE_ENABLED": "true", "TRUSTLINES_ENABLED": "true" } - 开发模式下的命令参数示例: 如果以开发模式运行,可以使用 'npx tsx' 命令: '["npx", "tsx", "C:/Users/YourName/RGB-MCP-SERVERv1/src/server.ts"]'
基本使用方法
一旦MCP服务器成功运行并通过MCP客户端配置,AI助手将能够:
- 查询可用工具: MCP客户端会自动发现并列出服务器暴露的所有工具(例如 'rgb_issue_asset', 'trustline_create', 'bridge_to_xrpl' 等),并获取它们的详细描述和输入参数要求。
- 调用工具执行操作: AI助手可以根据用户的指令或自身决策,选择并调用相应的工具来执行复杂的区块链操作。例如:
- 发行RGB资产: 如果用户想在比特币上发行一个名为“MyToken”的新代币,AI助手可以调用 'rgb_issue_asset' 工具,并提供代币名称、符号、发行量等参数。
- 进行链下信用转移: 用户希望通过信任链向朋友转移信用,AI助手可以调用 'trustline_transfer_credit' 工具,指定信任链ID、发送方、接收方和金额。
- 将资产桥接到XRPL: 如果用户希望将其RGB资产用于XRPL生态系统,AI助手可以调用 'bridge_to_xrpl' 工具,将资产从RGB转移到XRPL,并获取相应的XRPL IOU。
通过这种方式,AI助手可以无缝地与RGB智能合约、信任链和XRPL进行交互,处理各种复杂的资产管理和跨链交易请求。
信息
分类
开发者工具