Best for
- Developers who need to run AI-generated code safely
- Data scientists and analysts
- Users of Claude Desktop, Cursor, or VS Code
H
52FMRS · D
An officially maintained MCP server for HOPX sandboxed code execution, using stdio transport. Supports Python, JavaScript, Bash, and Go with a comprehensive toolset (execution, files, commands, environment variables), good documentation, and an MIT license. Best for users who need to run AI-generated code in an isolated cloud environment, provided they accept third-party cloud execution and manage an API key.
HOPX MCP Server is the official Model Context Protocol (MCP) server for HOPX, enabling AI assistants to execute code in isolated cloud containers. It supports Python, JavaScript, Bash, and Go, with pre-installed data analysis libraries like pandas, numpy, and matplotlib. It offers one-shot isolated execution and persistent sandboxes for multi-step workflows, with containers auto-destroyed after use. MIT-licensed, installed via the PyPI package hopx-mcp, runs over stdio, and requires an API key from hopx.ai.
Tools
execute_code_isolated
Execute code in an isolated sandbox with automatic cleanup
create_sandbox
Create a persistent sandbox for multi-step workflows
execute_code
Execute code in an existing sandbox
file_read
Read files from sandbox filesystem
file_write
Write files to sandbox filesystem
file_list
List files in the sandbox
file_exists
Check whether a file exists
file_remove
Remove a file
file_mkdir
Create a directory
execute_code_background
Run long-running tasks in the background
execute_code_async
Execute 30+ minute tasks with webhook callbacks
list_sandboxes
List sandboxes
delete_sandbox
Terminate a sandbox
run_command
Execute shell commands
run_command_background
Run background processes
env_get
Get environment variables
env_set
Set environment variables
env_clear
Clear environment variables
list_templates
Browse available templates
Setup
- Sign up at hopx.ai and get an API key; 2. Run uvx hopx-mcp (requires uv); 3. Add the MCP server config to your IDE (claude_desktop_config., .cursor/mcp., or .vscode/mcp.) with the HOPX_API_KEY environment variable; 4. Restart your IDE. Optionally set HOPX_BASE_URL (default https://api.hopx.dev).
claude_desktop_config.json
{"mcpServers":{"hopx-sandbox":{"command":"uvx","args":["hopx-mcp"],"env":{"HOPX_API_KEY":"your-api-key-here"}}}}
Fit and risk
Not for
- Scenarios requiring fully local code execution
- Organizations that cannot allow code to run on third-party cloud infrastructure
- Simple tasks that don't need sandboxing
Required permissions
- Requires HOPX_API_KEY (API key from hopx.ai)
- Containers have internet access enabled by default
- Code runs in the HOPX cloud, not locally
Risks and side effects
- Containers have internet access by default
- Code is executed in the HOPX cloud; follow your security policies for sensitive data
- Synchronous execution maxes at 300 seconds; sandbox lifetime defaults to 10 minutes
- Language support varies by template
Troubleshooting
- 401 Unauthorized: verify HOPX_API_KEY is set and valid
- Template not found: browse available templates with list_templates(limit=20)
- Slow first execution: container initialization takes ~3 seconds (VM auth setup); subsequent operations are immediate
Use cases
Data analysis with pandas/numpy/matplotlib
Persistent sandboxes for multi-step workflows
Running AI-generated code safely
Background and long-running task execution
Shell commands and file operations
Supported clients
Claude DesktopFull support
CursorFull support
VS CodeFull support