适合谁
- 需要安全运行 AI 生成代码的开发者
- 数据科学家和分析人员
- 使用 Claude Desktop、Cursor 或 VS Code 的用户
H
52FMRS · D
官方维护的 HOPX 沙箱代码执行 MCP 服务器，stdio 传输，支持 Python、JavaScript、Bash、Go，工具覆盖全面（执行、文件、命令、环境变量），文档完善，MIT 许可证。适合需要在隔离云端运行 AI 生成代码的用户，但需接受代码在第三方云端执行并管理 API 密钥。
HOPX MCP Server 是 HOPX 官方提供的模型上下文协议（MCP）服务器，让 AI 助手能够在隔离的云端容器中执行代码。支持 Python、JavaScript、Bash 和 Go，预装 pandas、numpy、matplotlib 等数据分析工具。支持一次性执行和持久沙箱（多步骤工作流），容器在使用后自动销毁。基于 MIT 许可证，通过 PyPI 包 hopx-mcp 安装，以 stdio 方式运行，需要 hopx.ai 的 API 密钥。
工具能力
execute_code_isolated
在隔离沙箱中执行代码，自动清理
create_sandbox
为多步骤工作流创建持久沙箱
execute_code
在现有沙箱中执行代码
file_read
读取沙箱文件系统中的文件
file_write
向沙箱文件系统写入文件
file_list
列出沙箱中的文件
file_exists
检查文件是否存在
file_remove
删除文件
file_mkdir
创建目录
execute_code_background
后台运行长任务
execute_code_async
通过 Webhook 回调执行超过 30 分钟的任务
list_sandboxes
列出沙箱
delete_sandbox
终止沙箱
run_command
执行 shell 命令
run_command_background
后台运行进程
env_get
获取环境变量
env_set
设置环境变量
env_clear
清除环境变量
list_templates
浏览可用模板
安装接入
- 在 hopx.ai 注册并获取 API 密钥；2. 运行 uvx hopx-mcp（需安装 uv）；3. 在 IDE 配置文件（如 claude_desktop_config.、.cursor/mcp. 或 .vscode/mcp.）中添加 MCP 服务器配置，设置 HOPX_API_KEY 环境变量；4. 重启 IDE。可选设置 HOPX_BASE_URL（默认 https://api.hopx.dev）。
claude_desktop_config.json
{"mcpServers":{"hopx-sandbox":{"command":"uvx","args":["hopx-mcp"],"env":{"HOPX_API_KEY":"your-api-key-here"}}}}
选型与风险
不适合谁
- 需要完全本地代码执行的场景
- 无法接受代码在第三方云端运行的组织
- 不需要沙箱隔离的简单任务
所需权限
- 需要 HOPX_API_KEY（hopx.ai 的 API 密钥）
- 默认允许容器访问互联网
- 代码在 HOPX 云端而非本地执行
风险与副作用
- 容器默认可访问互联网
- 代码在 HOPX 云端执行，敏感数据需遵循自身安全策略
- 同步执行最长 300 秒，沙箱默认存活 10 分钟
- 各模板对语言支持程度不同
常见排障
- 401 Unauthorized：检查 HOPX_API_KEY 是否已设置且有效
- Template not found：使用 list_templates(limit=20) 查看可用模板
- 首次执行缓慢：容器初始化约需 3 秒（VM 认证设置），后续操作即时
使用场景
用 pandas/numpy/matplotlib 进行数据分析
多步骤工作流的持久沙箱环境
运行 AI 助手生成的代码
执行后台和长时间运行的任务
运行 shell 命令和文件操作
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持