Go Sui MCP

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

Go言語で構築されたブロックチェーンSuiの管理制御平面サーバーです。REST APIを通じてローカルのSuiクライアントコマンドとやり取りすることができます。

🚀 クイックスタート

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

📚 ドキュメント

設定方法

以下の3つの設定方法をサポートしています。

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ファイルを参照してください。