Quickjs Sandbox

🚀 MCP QuickJS ランナー

このプロジェクトは、Model Context Protocol (MCP) を実装したサーバーです。WebAssembly (WASM) でコンパイルされた QuickJS エンジンを用いて、Node.js の組み込み WASI 実装で動作する任意の JavaScript コードを安全に実行するツールを提供します。

🚀 クイックスタート

このサーバーを使用することで、言語モデルや他の MCP クライアントが、ホストシステムにリスクを及ぼすことなく、信頼できない可能性のある JavaScript コードを安全に実行できます。

node server.ts

✨ 主な機能

• 安全な実行： QuickJS と Node.js WASI を使用して、WASM サンドボックス内で JavaScript を実行します。
• 標準入出力のキャプチャ： WASM 環境からの stdout と stderr をキャプチャします。
• エラーレポート： QuickJS のランタイムエラーと非ゼロの終了コードを報告します。
• MCP 統合： stdio を通じて MCP クライアントに標準機能を公開します。
• TypeScript で開発： 開発中の安全性を確保するために型安全を提供します。

📚 ドキュメント

説明

このサーバーは MCP ツールプロバイダーとして機能します。run_javascript_code という名前のツールを公開し、これは JavaScript コードの文字列を入力として受け取ります。その後、QuickJS WASM 環境で安全にこのコードを実行します。サーバーは実行中の標準出力 (stdout) と標準エラー (stderr) をキャプチャし、これらの結果とランタイムエラーを MCP クライアントに返します。

仕組み

1. WASM モジュール： WebAssembly システムインターフェース (WASI) を対象にコンパイルされた、事前にコンパイルされた QuickJS エンジン (qjs-wasi.wasm) を使用します。
2. Node.js WASI： Node.js の node:wasi モジュールを利用して、WASM モジュールをインスタンス化して実行します。
3. Stdio リダイレクト（一時ファイル）： WASM 環境の stdout と stderr をキャプチャするために、現在のサーバー実装は node:wasi と互換性のある標準的な方法に依存しています。
   • node:fs/promises と node:os を使用して、ホストファイルシステム上に一時ディレクトリを作成します。
   • そのディレクトリ内で stdout と stderr の一時ファイルを開きます。
   • 実際のオペレーティングシステムのファイルディスクリプタ を WASI インスタンスの初期化時に渡します（stdout: fd、stderr: fd）。
   • QuickJS WASM モジュールはこれらのディスクリプタに出力を書き込み、WASI を通じて一時ファイルにルーティングされます。
   • 実行が完了したら、サーバーはファイルハンドルを閉じ、一時ファイルの内容を読み取ります。
   • 一時ディレクトリとファイルをクリーンアップします。 (注意：メモリパイプや memfs のような仮想ファイルシステムを使用して一時ファイルを置き換える試みは失敗しました。なぜなら、node:wasi は現在、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