Sai MCP

🚀 WebAssembly Go を使用した SAI MCP サーバー

このプロジェクトは、WebAssembly で Go 言語を使用して管理制御プロトコル（MCP）サーバーを実装しています。このサーバーは、"sai" コマンドを実行し、その出力と終了コードを処理します。この実装は wpcli フレームワークと互換性があります。

🚀 クイックスタート

SAI MCP サーバーは、JavaScript から SAI コマンドラインツールを実行するためのインターフェースを提供する WebAssembly モジュールです。以下の内容を処理します。

1. 提供されたパラメータを持つ "sai" コマンドの実行
2. stdout、stderr、および終了コードのそれぞれのキャプチャ
3. 出力形式（YAML、JSON、または純テキスト）の解析
4. 構造化された結果を JavaScript 環境に返す

✨ 主な機能

プロジェクト構造

sai_mcp/
├── cmd/
│   └── main/
│       ├── main.go           # WebAssembly のエントリポイントと JavaScript インターフェース
│       ├── sai_executor.go   # SAI コマンドの実行ロジック
│       ├── parser.go         # 出力形式の解析（YAML、JSON）
│       └── main_test.go      # 実装のテストケース
└── go.mod                    # Go モジュールの定義

実装詳細

WebAssembly インターフェース

WebAssembly モジュールは、JavaScript 関数 executeSai を公開しています。この関数はコマンドパラメータを受け取り、以下の属性を持つオブジェクトを返します。

• stdout: 標準出力
• stderr: 標準エラー出力
• exitCode: 終了コード（0 は成功、非ゼロはエラー）
• parsedOutput: （オプション）形式が検出された場合、出力を解析したもの
• format: （オプション）検出された出力形式（json、yaml、テキスト）

SAI コマンドの実行

SaiExecutor コンポーネントは、SAI コマンドの実際の実行を処理します。

• SAI コマンドのために新しいプロセスを作成
• stdout と stderr をそれぞれキャプチャ
• プロセスから終了コードを抽出
• 実行エラーを適切に処理

出力解析

実装には、さまざまな出力形式のパーサーが含まれています。

• JSON: JSON 出力を構造化オブジェクトに解析
• YAML: YAML 出力を構造化オブジェクトに解析
• テキスト: 純テキストを生テキストとして返す

形式は、コマンドと出力内容に基づいて自動的に検出されます。

📦 インストール

WebAssembly モジュールのビルド

WebAssembly モジュールをビルドするには、以下のコマンドを実行します。

GOOS=js GOARCH=wasm go build -o sai_mcp.wasm ./cmd/main

これにより、wpcli フレームワークで読み込める WebAssembly ファイル（sai_mcp.wasm）が生成されます。

wpcli との統合

wpcli フレームワークと統合するには、以下の手順を実行します。

1. WebAssembly モジュールを適切なプラグインディレクトリに配置する
2. 利用可能なコマンドを定義する設定ファイルを作成する
3. プラグインを wpcli フレームワークに登録する

設定例：

name: sai
description: SAI コマンドラインツールの統合
uuid: sai-plugin-uuid
versions:
  - version: 1.0.0
    wasm: sai_mcp.wasm
    conf: sai_config.yaml
commands:
  - name: install
    description: ソフトウェアのインストール
    usage: install <software> [options]
    args:
      - name: software
        type: string
        description: インストールするソフトウェアの名前
        required: true
  # その他のコマンド...

💻 使用例

基本的な使用法

JavaScript からの使用例：

// SAI コマンドを実行
const result = executeSai("install", "nginx");

// 結果をチェック
console.log("終了コード:", result.exitCode);
console.log("出力:", result.stdout);
if (result.stderr) {
  console.error("エラー:", result.stderr);
}

// 解析された出力がある場合はアクセス
if (result.parsedOutput) {
  console.log("解析された出力:", result.parsedOutput);
}

🔧 技術詳細

エラー処理

実装では、さまざまなエラーシナリオを処理しています。

• コマンドが見つからない場合：stderr に適切なエラーを返し、非ゼロの終了コードを使用
• コマンドの実行に失敗した場合：エラーメッセージをキャプチャし、stderr に実際の終了コードを返す
• 出力解析エラー：解析できない出力は無視する

用語集

1. WebAssembly: ブラウザと非ブラウザ環境で、C++ と同等の速度で実行できるバイナリ命令形式。
2. Go: Google によって開発されたオープンソースのプログラミング言語で、効率、安全性、および保守性に重点を置いています。
3. MCP プロトコル: 分散システム内のコンポーネントを管理および制御するための管理制御プロトコル。
4. wpcli: コマンドラインインターフェースの構築と管理に使用される PHP ライブラリ。

以上の実装により、WebAssembly と Go を組み合わせて、SAI コマンドの効率的な実行と管理を提供することができます。