terrarium-mcp 0.1.1

package/README.md

@@ -0,0 +1,30 @@
+# terrarium-mcp
+
+Real, disposable VirtualBox VMs from the CLI or over MCP, for you and your AI
+agent. This package bundles the Windows binary of
+[terrarium](https://github.com/chryaner/terrarium) so nothing has to be
+installed first.
+
+Requires a Windows host with [VirtualBox](https://www.virtualbox.org/) 7.x.
+
+Give your agent real machines (Claude Code):
+
+```
+claude mcp add terrarium -- npx -y terrarium-mcp mcp
+```
+
+Use the CLI:
+
+```
+npx -y terrarium-mcp doctor
+npx -y terrarium-mcp fork debian-12 t1
+```
+
+Or install it globally so `terrarium` is on your PATH:
+
+```
+npm i -g terrarium-mcp
+```
+
+Docs, recipes and the demos are in the
+[repository](https://github.com/chryaner/terrarium).

package/bin/terrarium.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+'use strict';
+
+// Runs the bundled terrarium.exe on this process's stdio, so `npx terrarium-mcp
+// mcp` is the MCP server itself. Nothing may be written to stdout here: the
+// MCP transport owns it, and a stray byte breaks the client's framing.
+const { spawn } = require('child_process');
+const path = require('path');
+
+if (process.platform !== 'win32') {
+  process.stderr.write('terrarium runs on a Windows host with VirtualBox; this platform is not supported\n');
+  process.exit(1);
+}
+
+const exe = path.join(__dirname, '..', 'dist', 'terrarium.exe');
+const child = spawn(exe, process.argv.slice(2), { stdio: 'inherit', windowsHide: true });
+
+child.on('error', (err) => {
+  process.stderr.write('terrarium: ' + err.message + '\n');
+  process.exit(1);
+});
+child.on('exit', (code) => {
+  process.exit(code === null ? 1 : code);
+});
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => child.kill(sig));
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "terrarium-mcp",
+  "version": "0.1.1",
+  "description": "terrarium: disposable VirtualBox VMs from the CLI or over MCP, for you and your AI agent. Bundles the Windows binary.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chryaner/terrarium.git"
+  },
+  "homepage": "https://github.com/chryaner/terrarium",
+  "bugs": "https://github.com/chryaner/terrarium/issues",
+  "bin": {
+    "terrarium": "bin/terrarium.js"
+  },
+  "files": [
+    "bin/terrarium.js",
+    "dist/terrarium.exe"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "virtualbox",
+    "vm",
+    "disposable",
+    "sandbox",
+    "ai-agents",
+    "claude"
+  ]
+}