MCP QuickJS 运行器

一个实现了模型上下文协议 (MCP) 的服务器，它提供了一个工具，可以在编译为 WebAssembly (WASM) 的 QuickJS 引擎中安全地执行任意 JavaScript 代码，并使用 Node.js 内置的 WASI 实现来运行。

描述

此服务器充当 MCP 工具提供程序。它公开了一个名为 run_javascript_code 的工具，该工具接受一个 JavaScript 代码字符串作为输入。然后，该代码在沙盒化的 QuickJS WASM 环境中执行。服务器捕获执行的标准输出 (stdout) 和标准错误 (stderr) 流，并将它们以及任何执行错误返回给 MCP 客户端。

这允许语言模型或其他 MCP 客户端安全地执行可能不受信任的 JavaScript 代码片段，而不会危及主机系统。

特性

• 安全执行： 使用 QuickJS 和 Node.js WASI 在 WASM 沙箱中运行 JavaScript。
• 标准 I/O 捕获： 捕获已执行 JavaScript 代码的 stdout 和 stderr。
• 错误报告： 报告 QuickJS 的运行时错误和非零退出代码。
• MCP 集成： 通过 stdio 将功能公开为标准 MCP 工具。
• 使用 TypeScript 构建： 在开发期间提供类型安全。

工作原理

1. WASM 模块： 使用预编译的 QuickJS 引擎 (qjs-wasi.wasm)，该引擎面向 WebAssembly 系统接口 (WASI)。
2. Node.js WASI： 利用 Node.js 中的 node:wasi 模块来实例化和运行 WASM 模块。
3. Stdio 重定向（临时文件）： 为了从 WASM 环境捕获 stdout 和 stderr，服务器目前依赖于与 node:wasi 兼容的标准方法：
   • 使用 node:fs/promises 和 node:os 在主机文件系统上创建一个临时目录。
   • 在此目录中打开 stdout 和 stderr 的临时文件。
   • 这些文件的真实 OS 文件描述符在初始化期间传递给 WASI 实例 (stdout: fd, stderr: fd)。
   • QuickJS WASM 模块将其输出写入这些描述符，这些描述符由 WASI 路由到临时文件。
   • 执行完成后，服务器关闭文件句柄并读取临时文件的内容。
   • 临时目录和文件将被清理。
   • (注意：尝试使用内存管道或虚拟文件系统（如 memfs）均未成功，因为 node:wasi 目前需要真实的 OS 文件描述符用于 stdio。)
4. MCP 通信： 服务器使用 @modelcontextprotocol/sdk 来监听通过 stdio 发送的 MCP 请求，并根据协议格式化执行结果进行响应。

前提条件

• Node.js (建议 v23.x 或更高版本，请检查您的特定版本的 node:wasi 兼容性)
• npm 或 yarn
• QuickJS WASM 文件 (qjs-wasi.wasm) 必须与编译后的服务器脚本位于同一目录中（例如，相对于 ./dist/server.js 的 ./dist/qjs-wasi.wasm）。您可能需要单独获取或编译此文件。

安装

1. 克隆存储库（如果适用）。
2. 安装依赖项：

   npm install
   

用法

node server.ts