Skip to content
Back to search

mcp

Model Context Protocol (MCP) server for HOPX. Enables AI assistants to execute code in isolated cloud containers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hopx-ai--mcp/badge.svg)](/listings/hopx-ai--mcp)

HTML

<a href="/listings/hopx-ai--mcp"><img src="/api/listings/hopx-ai--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uvx hopx-mcp

Get your API key at [hopx.ai](https://hopx.ai).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 303 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # HOPX MCP Server
  2. Model Context Protocol (MCP) server for [HOPX](https://hopx.ai). Enables AI assistants to execute code in isolated cloud containers.
  3. **MCP Name:** `io.github.hopx-ai/hopx-mcp`
  4. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. [![Python](https://img.shields.io/badge/python-3.14+-blue.svg)](https://python.org)
  6. [![MCP](https://img.shields.io/badge/MCP-1.21+-green.svg)](https://modelcontextprotocol.io)
  7. ## Installation
  8. ```bash
  9. uvx hopx-mcp
  10. ```
  11. Get your API key at [hopx.ai](https://hopx.ai).
  12. ---
  13. ## Capabilities
  14. - Execute Python, JavaScript, Bash, and Go in isolated containers
  15. - Data analysis with pandas, numpy, matplotlib (pre-installed)
  16. - File operations and system commands
  17. - Background processes and long-running tasks
  18. Containers auto-destroy after use.
  19. ---
  20. ## Configuration
  21. ### Get API Key
  22. Sign up at [hopx.ai](https://hopx.ai).
  23. ### Configure IDE
  24. Add MCP server configuration to your IDE:
  25. <details>
  26. <summary><b>Claude Desktop</b></summary>
  27. Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
  28. ```json
  29. {
  30. "mcpServers": {
  31. "hopx-sandbox": {
  32. "command": "uvx",
  33. "args": ["hopx-mcp"],
  34. "env": {
  35. "HOPX_API_KEY": "your-api-key-here"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. Restart Claude Desktop after configuration.
  42. </details>
  43. <details>
  44. <summary><b>Cursor</b></summary>
  45. Add to `.cursor/mcp.json`:
  46. ```json
  47. {
  48. "mcpServers": {
  49. "hopx-sandbox": {
  50. "command": "uvx",
  51. "args": ["hopx-mcp"],
  52. "env": {
  53. "HOPX_API_KEY": "your-api-key-here"
  54. }
  55. }
  56. }
  57. }
  58. ```
  59. </details>
  60. <details>
  61. <summary><b>VS Code</b></summary>
  62. Add to `.vscode/mcp.json`:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "hopx-sandbox": {
  67. "command": "uvx",
  68. "args": ["hopx-mcp"],
  69. "env": {
  70. "HOPX_API_KEY": "your-api-key-here"
  71. }
  72. }
  73. }
  74. }
  75. ```
  76. </details>
  77. <details>
  78. <summary><b>Other IDEs</b></summary>
  79. Configuration format varies by IDE. Add these parameters:
  80. - Command: `uvx`
  81. - Args: `["hopx-mcp"]`
  82. - Environment: `HOPX_API_KEY=your-api-key-here`
  83. </details>
  84. ---
  85. ## Usage
  86. ### Quick Execution
  87. ```python
  88. execute_code_isolated(
  89. code='print("Hello, World!")',
  90. language='python',
  91. timeout=30
  92. )
  93. ```
  94. **Returns:**
  95. ```python
  96. {
  97. 'stdout': 'Hello, World!\n',
  98. 'exit_code': 0,
  99. 'execution_time': 0.123,
  100. 'sandbox_id': '1762778786mxaco6r2'
  101. }
  102. ```
  103. ### Persistent Sandbox
  104. For multiple operations in the same environment:
  105. ```python
  106. # Create sandbox
  107. sandbox = create_sandbox(
  108. template_id='code-interpreter',
  109. timeout_seconds=3600
  110. )
  111. sandbox_id = sandbox['id']
  112. # Run operations
  113. execute_code(sandbox_id, 'import pandas as pd')
  114. execute_code(sandbox_id, 'df = pd.read_csv("data.csv")')
  115. file_write(sandbox_id, '/workspace/output.txt', 'results')
  116. content = file_read(sandbox_id, '/workspace/output.txt')
  117. # Cleanup
  118. delete_sandbox(sandbox_id)
  119. ```
  120. ---
  121. ## Available Tools
  122. **Sandbox Management:**
  123. - `create_sandbox()` - Create sandbox
  124. - `list_sandboxes()` - List sandboxes
  125. - `delete_sandbox()` - Terminate sandbox
  126. **Code Execution:**
  127. - `execute_code_isolated()` - One-shot execution (recommended)
  128. - `execute_code()` - Execute in existing sandbox
  129. - `execute_code_background()` - Long-running tasks
  130. - `execute_code_async()` - Webhook callbacks for 30+ min tasks
  131. **File Operations:**
  132. - `file_read()`, `file_write()`, `file_list()`
  133. - `file_exists()`, `file_remove()`, `file_mkdir()`
  134. **Commands:**
  135. - `run_command()` - Execute shell commands
  136. - `run_command_background()` - Background processes
  137. **Environment:**
  138. - `env_get()`, `env_set()`, `env_clear()`
  139. ---
  140. ## Supported Languages
  141. - **Python 3.11+** - pandas, numpy, matplotlib, scipy, scikit-learn, requests
  142. - **JavaScript/Node.js 20** - Standard libraries
  143. - **Bash** - Unix utilities, git, curl, wget
  144. - **Go** - Compilation support
  145. ---
  146. ## Features
  147. - Sandbox creation: ~200ms
  148. - Container startup: ~0.1s
  149. - Auto-cleanup: 600s (configurable)
  150. - Internet access: Enabled by default
  151. - Isolation: Complete per execution
  152. - Authentication: JWT-based
  153. ---
  154. ## Environment Variables
  155. **Required:**
  156. ```bash
  157. HOPX_API_KEY=your-api-key
  158. ```
  159. **Optional:**
  160. ```bash
  161. HOPX_BASE_URL=https://api.hopx.dev # default
  162. ```
  163. ---
  164. ## Troubleshooting
  165. ### "401 Unauthorized"
  166. API key not set or invalid.
  167. **Solution:**
  168. ```bash
  169. echo $HOPX_API_KEY # Verify key is set
  170. ```
  171. ### "Template not found"
  172. Invalid template name.
  173. **Solution:**
  174. ```python
  175. templates = list_templates(limit=20) # Browse available templates
  176. ```
  177. ### Slow First Execution
  178. Container initializes in ~3 seconds after creation.
  179. **Cause:** VM authentication setup
  180. **Solution:** Subsequent operations are immediate
  181. ---
  182. ## Limitations
  183. - Synchronous execution: Max 300 seconds
  184. - Sandbox lifetime: Default 10 minutes (configurable)
  185. - Template-specific language support
  186. ---
  187. ## Security
  188. **Protected:**
  189. - Local system isolated from container execution
  190. - Containers isolated from each other
  191. - Auto-cleanup prevents resource leaks
  192. - JWT authentication per sandbox
  193. **Considerations:**
  194. - Containers have internet access by default
  195. - Code executed in HOPX cloud
  196. - Follow your security policies for sensitive data
  197. ---
  198. ## Support
  199. - Documentation: [docs.hopx.ai](https://docs.hopx.ai)
  200. - Issues: [GitHub](https://github.com/hopx-ai/mcp/issues)
  201. - Email: support@hopx.ai
  202. ---
  203. ## License
  204. MIT License. See [LICENSE](LICENSE) for details.
  205. HOPX Terms of Service: [hopx.ai/terms](https://hopx.ai/terms)
  206. ---
  207. ## Technical Details
  208. Built with:
  209. - [hopx-ai SDK](https://github.com/hopx-ai/hopx-python-sdk) v0.2.7
  210. - [FastMCP](https://github.com/jlowin/fastmcp) framework
  211. - [Model Context Protocol](https://modelcontextprotocol.io)
  212. ---
  213. [Website](https://hopx.ai) | [Documentation](https://docs.hopx.ai) | [GitHub](https://github.com/hopx-ai/mcp)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.