Sai MCP

🚀 SAI MCP Server Implemented in WebAssembly with Go

This project implements a Management Control Protocol (MCP) server in WebAssembly using the Go language. It's designed to execute "sai" commands and handle their output and exit codes. This implementation is compatible with the wpcli framework.

🚀 Quick Start

The SAI MCP server is a WebAssembly module that provides an interface to execute the SAI command-line tool from JavaScript. It handles the following tasks:

1. Execute the "sai" command with provided parameters.
2. Capture stdout, stderr, and the exit code separately.
3. Parse the output format (YAML, JSON, or plain text).
4. Return structured results to the JavaScript environment.

✨ Features

Project Structure

sai_mcp/
├── cmd/
│   └── main/
│       ├── main.go           # WebAssembly entry point and JavaScript interface
│       ├── sai_executor.go   # SAI command execution logic
│       ├── parser.go         # Output format parsing (YAML, JSON)
│       └── main_test.go      # Test cases for the implementation
└── go.mod                    # Go module definition

Implementation Details

WebAssembly Interface

The WebAssembly module exposes a JavaScript function executeSai, which takes command parameters and returns an object with the following properties:

• stdout: Standard output.
• stderr: Standard error output.
• exitCode: Exit code (0 for success, non-zero for errors).
• parsedOutput: (Optional) Parsed output if a format is detected.
• format: (Optional) Detected output format (json, yaml, text).

SAI Command Execution

The SaiExecutor component handles the actual execution of SAI commands:

• Create a new process for the SAI command.
• Capture stdout and stderr separately.
• Extract the exit code from the process.
• Handle execution errors appropriately.

Output Parsing

The implementation includes parsers for different output formats:

• JSON: Parse JSON output into a structured object.
• YAML: Parse YAML output into a structured object.
• Text: Return plain text as the raw text. The format is automatically detected based on the command and output content.

📦 Installation

Building the WebAssembly Module

To build the WebAssembly module, use the following command:

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

This will generate a WebAssembly file (sai_mcp.wasm) that can be loaded by the wpcli framework.

Integrating with wpcli

To integrate with the wpcli framework:

1. Place the WebAssembly module in the appropriate plugin directory.
2. Create a configuration file that defines the available commands.
3. Register the plugin with the wpcli framework.

Example configuration:

name: sai
description: SAI command-line tool integration
uuid: sai-plugin-uuid
versions:
  - version: 1.0.0
    wasm: sai_mcp.wasm
    conf: sai_config.yaml
commands:
  - name: install
    description: Install software
    usage: install <software> [options]
    args:
      - name: software
        type: string
        description: Name of the software to install
        required: true
  # Other commands...

💻 Usage Examples

Basic Usage

// Execute the SAI command
const result = executeSai("install", "nginx");

// Check the result
console.log("Exit code:", result.exitCode);
console.log("Output:", result.stdout);
if (result.stderr) {
  console.error("Error:", result.stderr);
}

// Access the parsed output if available
if (result.parsedOutput) {
  console.log("Parsed output:", result.parsedOutput);
}

🔧 Technical Details

Error Handling

The implementation handles various error scenarios:

• Command not found: Return an appropriate error in stderr and use a non-zero exit code.
• Command execution failure: Capture the error message and return the actual exit code in stderr.
• Output parsing error: Ignore unparsable output.

Glossary

1. WebAssembly: A binary instruction format that can run in browsers and non-browser environments at a speed close to that of C++ equivalents.
2. Go: An open-source programming language developed by Google, focusing on efficiency, security, and maintainability.
3. MCP Protocol: Management Control Protocol, used to manage and control components in distributed systems.
4. wpcli: A PHP library for building and managing command-line interfaces.

Through the combination of WebAssembly and Go, this implementation provides efficient execution and management for SAI commands.