Skip to content

Commit 8e32b4b

Browse files
committed
feat: add MCP server example for sandboxed JavaScript execution
Add an MCP (Model Context Protocol) server that exposes an execute_javascript tool, allowing AI agents to run arbitrary JavaScript inside an isolated Hyperlight micro-VM sandbox with strict CPU time limits and automatic snapshot/restore recovery after timeouts. Includes server implementation, demo scripts (PowerShell and Bash), vitest test suite, and documentation. Signed-off-by: Simon Davies <simongdavies@users.noreply.github.com>
1 parent 754139c commit 8e32b4b

13 files changed

Lines changed: 6986 additions & 0 deletions

src/js-host-api/examples/mcp-server/README.md

Lines changed: 721 additions & 0 deletions
Large diffs are not rendered by default.

src/js-host-api/examples/mcp-server/demo-copilot-cli.ps1

Lines changed: 801 additions & 0 deletions
Large diffs are not rendered by default.

src/js-host-api/examples/mcp-server/demo-copilot-cli.sh

Lines changed: 735 additions & 0 deletions
Large diffs are not rendered by default.
2.29 MB
Loading
2.49 MB
Binary file not shown.

src/js-host-api/examples/mcp-server/package-lock.json

Lines changed: 2592 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
{
2+
"name": "@hyperlight/mcp-server-example",
3+
"version": "0.1.0",
4+
"private": true,
5+
"type": "module",
6+
"description": "MCP server that executes JavaScript in a Hyperlight sandbox — safe, isolated, CPU-bounded",
7+
"main": "server.js",
8+
"scripts": {
9+
"start": "node server.js",
10+
"test": "vitest run"
11+
},
12+
"dependencies": {
13+
"@modelcontextprotocol/sdk": "^1.26.0",
14+
"zod": "^3.25.0"
15+
},
16+
"devDependencies": {
17+
"vitest": "^4.0.18"
18+
}
19+
}

0 commit comments

Comments
 (0)