JavaScript Sandbox MCP 服务器使用说明

项目简介

js-sandbox-mcp-server 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供安全的 JavaScript 代码执行环境。它通过 MCP 协议与 LLM 客户端通信，作为一个 工具 (Tool) 供 LLM 调用，允许 LLM 安全地执行 JavaScript 代码并获取结果，从而扩展 LLM 的功能边界，使其能够处理需要动态代码执行的任务。

主要功能点

安全 JavaScript 代码执行: 提供 'execute_js' 工具，允许 LLM 客户端发送 JavaScript 代码到服务器执行。代码在隔离的沙箱环境中运行，防止恶意代码影响系统安全。
可配置的执行环境: 支持设置代码执行的超时时间和内存限制，防止资源滥用，确保服务器稳定运行。
代码静态分析: 在执行代码前进行初步的静态分析，检测禁用关键词，提高安全性。
详细的执行结果: 返回代码执行结果、控制台输出、执行时间和内存使用情况，方便 LLM 客户端理解和利用执行结果。
MCP 协议标准支持: 遵循 MCP 协议规范，易于集成到支持 MCP 协议的 LLM 客户端，如 Claude Desktop。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 将 js-sandbox-mcp-server 仓库克隆到本地：

git clone https://github.com/garc33/js-sandbox-mcp-server.git
cd js-sandbox-mcp-server

安装依赖: 在仓库目录下运行 npm 命令安装项目依赖：
```
npm install
```
构建服务器: 运行构建命令编译 TypeScript 代码：
```
npm run build
```
构建完成后，会在 'build' 目录下生成服务器的可执行文件 'index.js'。

服务器配置

要将 js-sandbox-mcp-server 添加到 MCP 客户端（例如 Claude Desktop），你需要编辑客户端的配置文件，通常是一个 JSON 文件。以 Claude Desktop 为例，配置文件路径如下：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json' Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在 'claude_desktop_config.json' 文件中，找到或创建 'mcpServers' 字段，并添加 js-sandbox-mcp-server 的配置信息。配置信息是一个 JSON 对象，包含以下字段：

{
  "mcpServers": {
    "js-sandbox": {  // 服务器名称，可以自定义，用于在客户端中标识
      "command": "/path/to/js-sandbox/build/index.js" // js-sandbox-mcp-server 服务器的启动命令，指向构建后的 index.js 文件路径。请根据实际路径修改
    }
  }
}

注意: 请将 '/path/to/js-sandbox/build/index.js' 替换为你本地 js-sandbox-mcp-server 仓库 'build/index.js' 文件的实际绝对路径。

基本使用方法

启动服务器: 在 js-sandbox-mcp-server 仓库目录下，运行以下命令启动服务器：
```
npm run start
```
或者直接运行构建后的 'index.js' 文件：
```
node build/index.js
```
服务器启动后，会监听 MCP 客户端的请求。
在 MCP 客户端中使用: 配置完成后，在支持 MCP 协议的 LLM 客户端中，你就可以使用 'execute_js' 工具了。客户端会通过 MCP 协议与 js-sandbox-mcp-server 通信，并将 JavaScript 代码发送到服务器执行。

例如，在 Claude 中，你可以指示 Claude 使用 'execute_js' 工具执行 JavaScript 代码，例如：
```
请使用工具 execute_js 执行以下 JavaScript 代码：console.log('Hello from sandbox!');
```
js-sandbox-mcp-server 将会执行这段代码，并将执行结果返回给 Claude。Claude 可以根据返回的结果进行后续的对话或操作。

调试

如果需要调试 MCP 服务器，可以使用仓库 README 中推荐的 MCP Inspector 工具。通过运行 'npm run inspector' 启动 Inspector，它会提供一个浏览器 URL，用于监控和调试 MCP 服务器与客户端之间的通信。

关键词