使用 WebAssembly Go 实现的 SAI MCP 服务器

该项目在 WebAssembly 中使用 Go 语言实现了一个管理控制协议（MCP）服务器，用于执行 "sai" 命令并处理其输出和退出码。该实现与 wpcli 框架兼容。

总览

SAI MCP 服务器是一个 WebAssembly 模块，提供从 JavaScript 执行 SAI 命令行工具的接口。它处理以下内容：

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

这将生成一个 WebAssembly 文件（sai_mcp.wasm），该文件可以由 wpcli 框架加载。

与 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 命令提供高效的执行和管理。