HOPX MCP Server
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
HOPX MCP Server
Model Context Protocol (MCP) server for HOPX. Enables AI assistants to execute code in isolated cloud containers.
MCP Name: io.github.hopx-ai/hopx-mcp
Installation
uvx hopx-mcpGet your API key at hopx.ai.
Related MCP server: Code Executor MCP Server
Capabilities
Execute Python, JavaScript, Bash, and Go in isolated containers
Data analysis with pandas, numpy, matplotlib (pre-installed)
File operations and system commands
Background processes and long-running tasks
Containers auto-destroy after use.
Configuration
Get API Key
Sign up at hopx.ai.
Configure IDE
Add MCP server configuration to your IDE:
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}Restart Claude Desktop after configuration.
Add to .cursor/mcp.json:
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}Add to .vscode/mcp.json:
{
"mcpServers": {
"hopx-sandbox": {
"command": "uvx",
"args": ["hopx-mcp"],
"env": {
"HOPX_API_KEY": "your-api-key-here"
}
}
}
}Configuration format varies by IDE. Add these parameters:
Command:
uvxArgs:
["hopx-mcp"]Environment:
HOPX_API_KEY=your-api-key-here
Usage
Quick Execution
execute_code_isolated(
code='print("Hello, World!")',
language='python',
timeout=30
)Returns:
{
'stdout': 'Hello, World!\n',
'exit_code': 0,
'execution_time': 0.123,
'sandbox_id': '1762778786mxaco6r2'
}Persistent Sandbox
For multiple operations in the same environment:
# Create sandbox
sandbox = create_sandbox(
template_id='code-interpreter',
timeout_seconds=3600
)
sandbox_id = sandbox['id']
# Run operations
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')
# Cleanup
delete_sandbox(sandbox_id)Available Tools
Sandbox Management:
create_sandbox()- Create sandboxlist_sandboxes()- List sandboxesdelete_sandbox()- Terminate sandbox
Code Execution:
execute_code_isolated()- One-shot execution (recommended)execute_code()- Execute in existing sandboxexecute_code_background()- Long-running tasksexecute_code_async()- Webhook callbacks for 30+ min tasks
File Operations:
file_read(),file_write(),file_list()file_exists(),file_remove(),file_mkdir()
Commands:
run_command()- Execute shell commandsrun_command_background()- Background processes
Environment:
env_get(),env_set(),env_clear()
Supported Languages
Python 3.11+ - pandas, numpy, matplotlib, scipy, scikit-learn, requests
JavaScript/Node.js 20 - Standard libraries
Bash - Unix utilities, git, curl, wget
Go - Compilation support
Features
Sandbox creation: ~200ms
Container startup: ~0.1s
Auto-cleanup: 600s (configurable)
Internet access: Enabled by default
Isolation: Complete per execution
Authentication: JWT-based
Environment Variables
Required:
HOPX_API_KEY=your-api-keyOptional:
HOPX_BASE_URL=https://api.hopx.dev # defaultTroubleshooting
"401 Unauthorized"
API key not set or invalid.
Solution:
echo $HOPX_API_KEY # Verify key is set"Template not found"
Invalid template name.
Solution:
templates = list_templates(limit=20) # Browse available templatesSlow First Execution
Container initializes in ~3 seconds after creation.
Cause: VM authentication setup Solution: Subsequent operations are immediate
Limitations
Synchronous execution: Max 300 seconds
Sandbox lifetime: Default 10 minutes (configurable)
Template-specific language support
Security
Protected:
Local system isolated from container execution
Containers isolated from each other
Auto-cleanup prevents resource leaks
JWT authentication per sandbox
Considerations:
Containers have internet access by default
Code executed in HOPX cloud
Follow your security policies for sensitive data
Support
Documentation: docs.hopx.ai
Issues: GitHub
Email: support@hopx.ai
License
MIT License. See LICENSE for details.
HOPX Terms of Service: hopx.ai/terms
Technical Details
Built with:
hopx-ai SDK v0.2.7
FastMCP framework
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Execution platform for AI agents on Firecracker microVMs in the EU. Interactive Linux sandboxes with root, templates for Python, Node.js, Go, Rust and a headless browser, public HTTPS URLs. Background jobs that outlive the connection, batches of up to 1,000 jobs with dependencies, hard cost caps reserved up front, execution receipts with SHA-256, log digests that fit the context. IPv4, dual-stack or IPv6-only with its own public address, allowlists or no network. WASI runtime for small tasks. Idle sandboxes sleep and keep their files. Also REST API, Python SDK and LangChain.
Build Apps and run code in 30 languages ā sandboxed, with persistent sessions for agent loops.
Cloud Linux VMs for your agent: run code, Docker, files and HTTPS previews in a Sandboxer microVM.
Run Python code in a secure sandbox without local setup. Declare inline dependencies and execute sā¦
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables secure cloud-based execution of code across 14+ programming languages within a sandboxed environment. It supports file management, standard input/output handling, and automatic generation of visual artifacts like plots and charts.MIT
- AlicenseNot gradedqualityCmaintenanceProvides sandboxed code execution for AI agents with support for Python, JavaScript, and shell commands. Includes comprehensive safety features like destructive pattern blocking, timeout protection, and restricted file access for secure production use.35 PyPIMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to securely execute Python and JavaScript code in sandboxed environments, with file management and package installation.7MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to securely execute Python and C++ code snippets inside disposable, isolated Docker containers and receive structured results.31MIT