🚀 Go Sui MCP (管理控制平面)

Go Sui MCP 是一个基于 Go 语言开发的区块链 Sui 管理控制平面服务器。它提供了 REST API 用于与本地 Sui 客户端命令进行交互，极大地提升了对 Sui 区块链操作的便捷性和效率。

✨ 主要特性

• 支持通过 RESTful API 执行 Sui 客户端操作，方便开发者进行集成和调用。
• 具备命令行界面，可用于服务器的控制和管理。
• 支持通过配置文件、环境变量或命令行标志进行灵活配置。

📦 安装指南

安装步骤

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

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

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

先决条件

• 需安装 Go 语言，版本要求 1.20 及以上。
• Sui 客户端已安装并添加到系统的 PATH 中。

📚 详细文档

配置方式

支持以下三种配置方式：

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 文件。