js-sandbox-mcp-server

🚀 JS - Sandbox MCP 服务器

JS - Sandbox MCP 服务器是一个模型上下文协议服务器，它能提供安全的 JavaScript 执行环境，保障代码在安全可控的条件下运行。

🚀 快速开始

若要使用 JS - Sandbox MCP 服务器，您需要完成安装依赖、构建服务器等步骤，具体可参考下方的安装指南。

✨ 主要特性

工具

• execute_js：可在隔离环境中执行 JavaScript 代码。
  • 参数：
    • code（必需）：待执行的 JavaScript 代码。
    • timeout（可选）：最大执行时间，单位为毫秒（范围在 100 - 30000ms 之间）。
    • memory（可选）：内存限制，单位为字节（范围在 1MB - 100MB 之间）。
  • 返回值：代码执行的结果。

安全

• 隔离执行：在受控环境中对代码执行进行隔离，防止代码对外部环境造成不良影响。
• 资源限制：可配置代码的可执行时间和内存限制，有效避免资源过度占用。
• 恶意防护：具备防护恶意代码的能力，保障系统安全。

📦 安装指南

开发环境准备

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 开发模式下自动重建：

npm run watch

与 Claude 桌面配合使用

在与 Claude 桌面配合使用时，需添加服务器配置：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

配置文件内容如下：

{
  "mcpServers": {
    "js - sandbox": {
      "command": "/path/to/js - sandbox/build/index.js"
    }
  }
}

调试说明

由于 MCP 服务器通过 stdio 通信，调试可能具有一定挑战性。我们推荐使用 MCP Inspector 进行调试，可通过以下命令获得：

npm run inspector

Inspector 将提供一个访问调试工具的 URL，您在浏览器中打开该 URL 即可进行调试。