Go Sui MCP

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