302AI 沙箱 MCP 服务器使用说明

项目简介

302AI 沙箱 MCP 服务器是一个实现了 Model Context Protocol (MCP) 的后端服务，它为大型语言模型（LLM）客户端，如 Claude、Cherry Studio 和 ChatWise 等，提供代码沙箱环境和丰富的工具集。通过这个服务器，AI 助手可以安全地执行任意代码，访问文件系统，并与外部环境进行交互，从而扩展了 AI 的能力边界。

主要功能点

安全代码执行: 提供隔离的沙箱环境，允许 AI 助手安全执行代码，无需担心安全风险。
动态工具加载: 工具列表可以从远程服务器动态更新，保持工具的最新状态。
多种运行模式: 支持 'stdin' 模式本地运行，也支持作为远程 HTTP 服务器部署。
丰富的工具集: 内置多种实用工具，例如：
- 代码执行 (支持多种语言)
- 沙箱创建与销毁
- 文件信息查询
- 文件导入导出
- 命令行执行

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node 包管理器)。
安装依赖: 在项目根目录下，打开终端并执行以下命令安装项目依赖：
```
npm install
```
构建服务器: 执行以下命令构建服务器代码：
```
npm run build
```

服务器配置

MCP 客户端（如 Claude Desktop, Cherry Studio, ChatWise）需要配置 MCP 服务器的连接信息才能使用 302AI 沙箱 MCP 服务器提供的功能。以下是针对不同客户端的配置示例，您需要将这些配置信息添加到您的 MCP 客户端设置中。

通用配置说明 (JSON 格式):

{
  "mcpServers": {
    "服务器名称 (server name，自定义，例如: 302ai-sandbox-mcp)": {
      "command": "服务器启动命令 (command，通常为 npx)",
      "args": ["服务器启动参数 (args，例如: -y @302ai/sandbox-mcp)"],
      "env": {
        "302AI_API_KEY": "您的 302AI API 密钥 (YOUR_API_KEY_HERE，请替换为您的实际密钥)"
      }
    }
  }
}

各客户端配置示例:

Claude Desktop:

配置文件路径：
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
配置内容示例：

{
  "mcpServers": {
    "302ai-sandbox-mcp": {
      "command": "npx",
      "args": ["-y", "@302ai/sandbox-mcp"],
      "env": {
        "302AI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cherry Studio:

配置内容示例：

{
  "mcpServers": {
    "Li2ZXXJkvhAALyKOFeO4N": {
      "name": "302ai-sandbox-mcp",
      "description": "",
      "isActive": true,
      "registryUrl": "",
      "command": "npx",
      "args": [
        "-y",
        "@302ai/[email protected]"
      ],
      "env": {
        "302AI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

ChatWise:

配置步骤：复制以下 JSON 内容到剪贴板，然后在 ChatWise 设置 -> 工具 -> 添加按钮 -> 选择 "Import from Clipboard" 导入。
配置内容示例：

{
  "mcpServers": {
    "302ai-sandbox-mcp": {
      "command": "npx",
      "args": ["-y", "@302ai/sandbox-mcp"],
      "env": {
        "302AI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

获取 302AI API 密钥:

您需要在 302.AI 平台获取您的 API 密钥，并将其替换到上述配置示例中的 '"YOUR_API_KEY_HERE"' 位置。

基本使用方法

启动 MCP 服务器: 配置完成后，MCP 服务器会在 MCP 客户端启动时自动启动。您无需手动运行服务器。
在 MCP 客户端中使用工具: 在支持 MCP 协议的客户端（如 Claude、Cherry Studio、ChatWise）中，您可以像使用普通工具一样调用 302AI 沙箱 MCP 服务器提供的工具。具体的调用方式取决于客户端的界面和操作流程。通常，您可以通过自然语言指令指示 AI 助手使用特定工具，例如 "执行 Python 代码打印 'Hello, world!'", "查询当前目录下的文件列表" 等。

调试

如果遇到问题，可以使用 MCP Inspector 进行调试。运行以下命令启动 Inspector：

npm run inspector

Inspector 会提供一个 URL，您可以在浏览器中访问调试工具。

关键词