项目介绍
HOPX MCP Server
适用于HOPX的模型上下文协议（MCP）服务器。使AI助手能够在隔离的云容器中执行代码。
MCP名称: io.github.hopx-ai/hopx-mcp
安装
uvx hopx-mcp
在hopx.ai获取您的API密钥。
功能
- 在隔离的容器中执行Python、JavaScript、Bash和Go代码
- 使用pandas、numpy、matplotlib进行数据分析（预安装）
- 文件操作和系统命令
- 后台进程和长时间运行的任务
容器在使用后会自动销毁。
配置
获取API密钥
在hopx.ai注册。
配置IDE
向您的IDE添加MCP服务器配置：
<details> <summary><b>Claude Desktop</b></summary>添加到~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或%APPDATA%\Claude\claude_desktop_config.json（Windows）：
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}
配置后重启Claude Desktop。
</details> <details> <summary><b>Cursor</b></summary>添加到.cursor/mcp.json：
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}
添加到.vscode/mcp.json：
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}
配置格式因IDE而异。添加以下参数：
- 命令：
uvx - 参数：
["hopx-mcp"] - 环境变量：
HOPX_API_KEY=your-api-key-here
使用方法
快速执行
execute_code_isolated(
code='print("Hello, World!")',
language='python',
timeout=30
)
返回值：
{
'stdout': 'Hello, World!\n',
'exit_code': 0,
'execution_time': 0.123,
'sandbox_id': '1762778786mxaco6r2'
}
持久沙箱
在同一环境中执行多个操作：
# 创建沙箱
sandbox = create_sandbox(
template_id='code-interpreter',
timeout_seconds=3600
)
sandbox_id = sandbox['id']
# 执行操作
execute_code(sandbox_id, 'import pandas as pd')
execute_code(sandbox_id, 'df = pd.read_csv("data.csv")')
file_write(sandbox_id, '/workspace/output.txt', 'results')
content = file_read(sandbox_id, '/workspace/output.txt')
# 清理
delete_sandbox(sandbox_id)
可用工具
沙箱管理：
create_sandbox()- 创建沙箱list_sandboxes()- 列出沙箱delete_sandbox()- 终止沙箱
代码执行：
execute_code_isolated()- 单次执行（推荐）execute_code()- 在现有沙箱中执行execute_code_background()- 长时间运行任务execute_code_async()- 超过30分钟的任务使用Webhook回调
文件操作：
file_read(),file_write(),file_list()file_exists(),file_remove(),file_mkdir()
命令：
run_command()- 执行shell命令run_command_background()- 后台进程
环境：
env_get(),env_set(),env_clear()
支持的语言
- Python 3.11+ - pandas, numpy, matplotlib, scipy, scikit-learn, requests
- JavaScript/Node.js 20 - 标准库
- Bash - Unix工具，git, curl, wget
- Go - 编译支持
特性
- 沙箱创建：~200毫秒
- 容器启动：~0.1秒
- 自动清理：600秒（可配置）
- 默认启用互联网访问
- 每次执行完全隔离
- 基于JWT的身份验证
环境变量
必需：
HOPX_API_KEY=your-api-key
可选：
HOPX_BASE_URL=https://api.hopx.dev # 默认值
故障排除
"401未授权"
API密钥未设置或无效。
解决方案：
echo $HOPX_API_KEY # 验证密钥是否已设置
"模板未找到"
无效的模板名称。
解决方案：
templates = list_templates(limit=20) # 浏览可用模板
第一次执行缓慢
容器在创建后约3秒初始化。
原因： VM身份验证设置 解决方案： 后续操作立即执行
限制
- 同步执行：最大300秒
- 沙箱生命周期：默认10分钟（可配置）
- 模板特定语言支持
安全
保护措施：
- 本地系统与容器执行隔离
- 容器之间相互隔离
- 自动清理防止资源泄漏
- 每个沙箱基于JWT的身份验证
注意事项：
- 容器默认具有互联网访问权限
- 代码在HOPX云中执行
- 对敏感数据遵循您的安全策略
支持
- 文档：docs.hopx.ai
- 问题：GitHub
- 邮件：support@hopx.ai
许可证
MIT许可证。详情见LICENSE。
HOPX服务条款：hopx.ai/terms
技术细节
构建于：
- hopx-ai SDK v0.2.7
- FastMCP框架
- 模型上下文协议