Go Sui MCP (管理控制平面)

一个基于Go语言的区块链Sui的管理控制平面服务器，提供REST API与本地Sui客户端命令交互。

功能特性

• RESTful API支持Sui客户端操作
• 命令行界面用于服务器控制
• 通过配置文件、环境变量或命令行标志进行配置

先决条件

• Go语言版本1.20及以上
• Sui客户端已安装并添加到PATH中

安装步骤

# 克隆仓库
git clone https://github.com/krli/go-sui-mcp.git
cd go-sui-mcp

# 编译应用
go build -o go-sui-mcp

# 启动服务器
./go-sui-mcp server

配置方式

支持以下三种配置方式：

1. 配置文件（默认路径：$HOME/.go-sui-mcp.yaml）
2. 环境变量
3. 命令行参数

示例配置文件：

server:
  port: 8080
  host: "0.0.0.0"
sui:
  executable_path: "sui"

环境变量设置：

GOSUI_SERVER_PORT=8080
GOSUI_SERVER_HOST=0.0.0.0
GOSUI_SUI_EXECUTABLE_PATH=sui

API接口

健康检查

GET /health

Sui客户端API

GET /api/sui/version                 # 获取Sui客户端版本信息
GET /api/sui/balance/:address        # 查询指定地址的余额
GET /api/sui/objects/:address        # 获取指定地址的所有对象
GET /api/sui/validators              # 获取活动验证节点列表
GET /api/sui/network                 # 获取网络信息
GET /api/sui/transaction/:txid       # 获取交易详情
POST /api/sui/transfer               # 发送SUI代币

POST /api/sui/transfer

请求体示例：

{
  "recipient": "0x123456789abcdef",
  "amount": "1000000000",
  "gas_budget": "10000"
}

使用示例

获取Sui客户端版本：

curl http://localhost:8080/api/sui/version

查询指定地址的余额：

curl http://localhost:8080/api/sui/balance/0x123456789abcdef

许可证

见LICENSE文件。