关键词

代码执行沙箱Docker多语言支持自动化依赖管理

使用说明

项目简介

Code Sandbox MCP (模型上下文协议服务器) 提供了一个安全隔离的沙箱环境，用于执行代码。它使用 Docker 容器来确保代码运行的安全性，并支持多种编程语言。此 MCP 服务器旨在为 AI 应用程序提供代码执行能力，例如，当 AI 模型需要运行代码来验证想法或执行特定任务时，可以使用此服务器。

主要功能点

  • 多语言支持: 支持 Python、Go 和 Node.js 代码的执行。
  • TypeScript 支持: 内置支持 TypeScript 和 JSX/TSX 文件。
  • 依赖管理: 自动处理项目依赖，包括 Python (pip)、Go (go mod) 和 Node.js (npm/bun)。
  • 灵活执行: 支持单文件代码片段和完整项目的执行，并允许自定义入口命令。
  • 后台模式: 支持长时间运行的后台服务。
  • 实时输出: 实时捕获和流式传输容器日志。
  • 安全性: 使用 Docker 容器提供隔离的执行环境，保障安全。

安装步骤

前置条件

快速安装 (推荐)

您可以使用一键安装脚本快速安装 Code Sandbox MCP。

Linux, MacOS: 打开终端并执行以下命令：

curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash

Windows: 打开 PowerShell 并执行以下命令：

irm https://raw.githubusercontent.com/Automata-labs-team/code-sandbox-mcp/main/install.ps1 | iex

安装脚本会自动检测您的操作系统，下载对应的 Code Sandbox MCP 二进制文件，并将其配置到 Claude Desktop 的配置文件中（如果检测到 Claude Desktop）。

手动安装 (可选)

如果您希望手动安装，请按照以下步骤操作：

  1. 访问 发布页面 下载适用于您操作系统的最新版本。
  2. 将下载的二进制文件放置到您系统的 PATH 环境变量包含的目录中。
  3. 在类 Unix 系统 (Linux, macOS) 上，您可能需要赋予该二进制文件执行权限。打开终端，导航到二进制文件所在目录，并执行命令： 
    chmod +x code-sandbox-mcp

服务器配置

Code Sandbox MCP 服务器主要用于配合 MCP 客户端（如 Claude Desktop）使用。以下是配置 Code Sandbox MCP 服务器的 'claude_desktop_config.json' 示例，此配置文件通常由安装脚本自动创建。如果您需要手动配置，请参考以下信息。

根据您的操作系统，'claude_desktop_config.json' 文件通常位于以下路径：

  • Linux: '~/.config/Claude/claude_desktop_config.json'
  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

打开或创建 'claude_desktop_config.json' 文件，并添加或修改 'mcpServers' 部分，示例如下：

{
  "mcpServers": {
    "code-sandbox-mcp": {
      "command": "/path/to/code-sandbox-mcp",  //  Code Sandbox MCP  二进制文件的绝对路径。如果是手动安装，请替换为您实际的路径。
      "args": [],                           //  启动服务器时传递的命令行参数，默认为空数组。
      "env": {}                            //  服务器运行所需的环境变量，默认为空对象。
    }
  }
}

注意:

  • 请将 '"command"' 字段的值替换为 'code-sandbox-mcp' 二进制文件的实际路径。如果您使用了快速安装脚本，脚本会自动配置正确的路径。
  • '"args"' 字段可以用于传递额外的命令行参数给 'code-sandbox-mcp' 服务器。例如，您可以指定端口号 '--port' 或传输协议 '--transport' (stdio, sse)。 默认配置通常无需修改此项。
  • '"env"' 字段用于设置服务器运行时的环境变量，通常情况下无需设置。

基本使用方法

  1. 启动服务器: Code Sandbox MCP 服务器通常由 MCP 客户端（例如 Claude Desktop）在需要时自动启动。如果您需要手动启动服务器进行测试，可以在终端中运行 'code-sandbox-mcp' 二进制文件。

  2. 在 MCP 客户端中使用: 在支持 MCP 服务器配置的 AI 客户端（如 Claude Desktop）中，配置并启用 "code-sandbox-mcp" 服务器。客户端将通过 MCP 协议与 Code Sandbox MCP 服务器通信，并利用其提供的 'run_code' 和 'run_project' 工具来执行代码。

  3. 使用 'run_code' 工具: 此工具允许您在沙箱环境中运行代码片段。您需要提供代码内容和编程语言作为参数。服务器将返回代码执行的日志输出。

  4. 使用 'run_project' 工具: 此工具允许您在沙箱环境中运行整个项目。您需要提供项目目录的路径、编程语言以及项目入口命令。服务器将返回容器日志资源的 URI，您可以通过该 URI 获取项目的执行日志。

示例使用场景:

在 Claude Desktop 中，您可以指示 Claude 使用 'run_code' 工具来执行 Python 代码，例如：

'Run Python code: print("Hello from Claude!")'

Claude Desktop 将会调用 Code Sandbox MCP 服务器的 'run_code' 工具，在沙箱环境中执行 Python 代码，并将执行结果返回给您。

信息

分类

AI与计算

访问项目