@nimblebrain/mpak 0.0.1-beta.1 → 0.0.1-beta.3

package/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node dist/index.js:*)",
+      "Bash(npm test:*)",
+      "Bash(npm run build:*)",
+      "Bash(npm run test:all:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(npm version:*)",
+      "Bash(npm publish:*)",
+      "Bash(git push)",
+      "Bash(git tag:*)",
+      "Bash(git push:*)"
+    ]
+  }
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - run: npm ci
+
+      - run: npm run build
+
+      - run: npm run typecheck
+
+      - run: npm run test:all

package/CLAUDE.md

@@ -16,6 +16,7 @@ This is a standalone CLI that uses only the public v1 API. It has no dependencie
 | `src/commands/packages/search.ts` | Search command implementation |
 | `src/commands/packages/show.ts` | Show/info command implementation |
 | `src/commands/packages/pull.ts` | Pull/install command implementation |
+| `src/commands/packages/run.ts` | Run command implementation (caching, extraction, execution) |
 | `src/utils/config-manager.ts` | Config file handling (~/.mpak/config.json) |
 
 ### Type Generation
@@ -102,6 +103,7 @@ npm run typecheck
 | `info <package>` | Alias for show |
 | `pull <package>` | Download a bundle |
 | `install <package>` | Alias for pull |
+| `run <package>` | Run an MCP server (pulls, caches, executes) |
 
 ## Design Decisions
 

package/README.md

@@ -1,5 +1,12 @@
 # mpak CLI
 
+[![CI](https://github.com/NimbleBrainInc/mpak-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/NimbleBrainInc/mpak-cli/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![npm](https://img.shields.io/npm/v/@nimblebrain/mpak)](https://www.npmjs.com/package/@nimblebrain/mpak)
+[![node](https://img.shields.io/node/v/@nimblebrain/mpak)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://www.nimblebrain.ai/discord?utm_source=github&utm_medium=readme&utm_campaign=mpak-cli&utm_content=discord-badge)
+
 CLI for discovering and downloading MCPB bundles from the mpak registry.
 
 ## Installation
@@ -31,6 +38,7 @@ mpak pull @owner/my-server@1.0.0  # specific version
 | `info <package>` | Alias for show |
 | `pull <package>` | Download a bundle |
 | `install <package>` | Alias for pull |
+| `run <package>` | Run an MCP server from the registry |
 
 ### search
 
@@ -92,6 +100,39 @@ Options:
 - `--arch <arch>` - Target architecture: x64, arm64
 - `--json` - Output download info as JSON (doesn't download)
 
+### run
+
+Run an MCP server directly from the registry. Bundles are cached locally for fast subsequent runs.
+
+```bash
+# Run latest version
+mpak run @nimblebraininc/echo
+
+# Run specific version
+mpak run @nimblebraininc/echo@1.0.0
+
+# Force re-download (update cache)
+mpak run @nimblebraininc/echo --update
+```
+
+Options:
+- `--update` - Force re-download even if cached
+
+**Claude Desktop Integration:**
+
+```json
+{
+  "mcpServers": {
+    "echo": {
+      "command": "mpak",
+      "args": ["run", "@nimblebraininc/echo"]
+    }
+  }
+}
+```
+
+Bundles are cached in `~/.mpak/cache/` and automatically extracted on first run.
+
 ## Configuration
 
 Configuration is stored in `~/.mpak/config.json`:

package/dist/commands/packages/run.d.ts

@@ -0,0 +1,8 @@
+export interface RunOptions {
+    update?: boolean;
+}
+/**
+ * Run a package from the registry
+ */
+export declare function handleRun(packageSpec: string, options?: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/packages/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/packages/run.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiID;;GAEG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAyIf"}

package/dist/commands/packages/run.js

@@ -0,0 +1,216 @@
+import { spawn, spawnSync } from 'child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { RegistryClient } from '../../lib/api/registry-client.js';
+/**
+ * Parse package specification into name and version
+ */
+function parsePackageSpec(spec) {
+    const lastAtIndex = spec.lastIndexOf('@');
+    if (lastAtIndex <= 0) {
+        return { name: spec };
+    }
+    const name = spec.substring(0, lastAtIndex);
+    const version = spec.substring(lastAtIndex + 1);
+    if (!name.startsWith('@')) {
+        return { name: spec };
+    }
+    return { name, version };
+}
+/**
+ * Get cache directory for a package
+ */
+function getCacheDir(packageName) {
+    const cacheBase = join(homedir(), '.mpak', 'cache');
+    // @scope/name -> scope/name
+    const safeName = packageName.replace('@', '').replace('/', '-');
+    return join(cacheBase, safeName);
+}
+/**
+ * Read cache metadata
+ */
+function getCacheMetadata(cacheDir) {
+    const metaPath = join(cacheDir, '.mpak-meta.json');
+    if (!existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(metaPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write cache metadata
+ */
+function writeCacheMetadata(cacheDir, metadata) {
+    const metaPath = join(cacheDir, '.mpak-meta.json');
+    writeFileSync(metaPath, JSON.stringify(metadata, null, 2));
+}
+/**
+ * Extract ZIP file to directory (simple implementation without external deps)
+ */
+async function extractZip(zipPath, destDir) {
+    // Use native unzip command (available on macOS, Linux, and Windows with WSL)
+    const { execSync } = await import('child_process');
+    // Ensure destination exists
+    mkdirSync(destDir, { recursive: true });
+    try {
+        execSync(`unzip -o -q "${zipPath}" -d "${destDir}"`, { stdio: 'pipe' });
+    }
+    catch (error) {
+        throw new Error(`Failed to extract bundle: ${error.message}`);
+    }
+}
+/**
+ * Read manifest from extracted bundle
+ */
+function readManifest(cacheDir) {
+    const manifestPath = join(cacheDir, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        throw new Error(`Manifest not found in bundle: ${manifestPath}`);
+    }
+    return JSON.parse(readFileSync(manifestPath, 'utf8'));
+}
+/**
+ * Resolve placeholders in args (e.g., ${__dirname})
+ */
+function resolveArgs(args, cacheDir) {
+    return args.map(arg => arg.replace(/\$\{__dirname\}/g, cacheDir));
+}
+/**
+ * Find Python executable (tries python3 first, then python)
+ */
+function findPythonCommand() {
+    // Try python3 first (preferred on macOS/Linux)
+    const result = spawnSync('python3', ['--version'], { stdio: 'pipe' });
+    if (result.status === 0) {
+        return 'python3';
+    }
+    // Fall back to python
+    return 'python';
+}
+/**
+ * Run a package from the registry
+ */
+export async function handleRun(packageSpec, options = {}) {
+    const { name, version: requestedVersion } = parsePackageSpec(packageSpec);
+    const client = new RegistryClient();
+    const platform = RegistryClient.detectPlatform();
+    const cacheDir = getCacheDir(name);
+    let needsPull = true;
+    let cachedMeta = getCacheMetadata(cacheDir);
+    // Check if we have a cached version
+    if (cachedMeta && !options.update) {
+        if (requestedVersion) {
+            // Specific version requested - check if cached version matches
+            needsPull = cachedMeta.version !== requestedVersion;
+        }
+        else {
+            // Latest requested - use cache (user can --update to refresh)
+            needsPull = false;
+        }
+    }
+    if (needsPull) {
+        // Fetch download info
+        const downloadInfo = await client.getDownloadInfo(name, requestedVersion, platform);
+        const bundle = downloadInfo.bundle;
+        // Check if cached version is already the latest
+        if (cachedMeta && cachedMeta.version === bundle.version && !options.update) {
+            needsPull = false;
+        }
+        if (needsPull) {
+            // Download to temp file
+            const tempPath = join(homedir(), '.mpak', 'tmp', `${Date.now()}.mcpb`);
+            mkdirSync(dirname(tempPath), { recursive: true });
+            process.stderr.write(`=> Pulling ${name}@${bundle.version}...\n`);
+            await client.downloadBundle(downloadInfo.url, tempPath);
+            // Clear old cache and extract
+            const { rmSync } = await import('fs');
+            if (existsSync(cacheDir)) {
+                rmSync(cacheDir, { recursive: true, force: true });
+            }
+            mkdirSync(cacheDir, { recursive: true });
+            await extractZip(tempPath, cacheDir);
+            // Write metadata
+            writeCacheMetadata(cacheDir, {
+                version: bundle.version,
+                pulledAt: new Date().toISOString(),
+                platform: bundle.platform,
+            });
+            // Cleanup temp file
+            rmSync(tempPath, { force: true });
+            process.stderr.write(`=> Cached ${name}@${bundle.version}\n`);
+        }
+    }
+    // Read manifest and execute
+    const manifest = readManifest(cacheDir);
+    const { type, entry_point, mcp_config } = manifest.server;
+    let command;
+    let args;
+    let env = { ...process.env, ...mcp_config.env };
+    switch (type) {
+        case 'binary': {
+            // For binary, the entry_point is the executable path relative to bundle
+            command = join(cacheDir, entry_point);
+            args = resolveArgs(mcp_config.args || [], cacheDir);
+            // Ensure binary is executable
+            try {
+                chmodSync(command, 0o755);
+            }
+            catch {
+                // Ignore chmod errors on Windows
+            }
+            break;
+        }
+        case 'node': {
+            command = mcp_config.command || 'node';
+            // Use mcp_config.args directly if provided, otherwise fall back to entry_point
+            if (mcp_config.args && mcp_config.args.length > 0) {
+                args = resolveArgs(mcp_config.args, cacheDir);
+            }
+            else {
+                args = [join(cacheDir, entry_point)];
+            }
+            break;
+        }
+        case 'python': {
+            // Use manifest command if specified, otherwise auto-detect python
+            command = mcp_config.command === 'python' ? findPythonCommand() : (mcp_config.command || findPythonCommand());
+            // Use mcp_config.args directly if provided, otherwise fall back to entry_point
+            if (mcp_config.args && mcp_config.args.length > 0) {
+                args = resolveArgs(mcp_config.args, cacheDir);
+            }
+            else {
+                args = [join(cacheDir, entry_point)];
+            }
+            // Set PYTHONPATH to deps/ directory for dependency resolution
+            const depsDir = join(cacheDir, 'deps');
+            const existingPythonPath = process.env.PYTHONPATH;
+            env.PYTHONPATH = existingPythonPath ? `${depsDir}:${existingPythonPath}` : depsDir;
+            break;
+        }
+        default:
+            throw new Error(`Unsupported server type: ${type}`);
+    }
+    // Spawn with stdio passthrough for MCP
+    const child = spawn(command, args, {
+        stdio: ['inherit', 'inherit', 'inherit'],
+        env,
+        cwd: cacheDir,
+    });
+    // Forward signals
+    process.on('SIGINT', () => child.kill('SIGINT'));
+    process.on('SIGTERM', () => child.kill('SIGTERM'));
+    // Wait for exit
+    child.on('exit', (code) => {
+        process.exit(code ?? 0);
+    });
+    child.on('error', (error) => {
+        process.stderr.write(`=> Failed to start server: ${error.message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/packages/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/packages/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/packages/show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/packages/show.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Hf"}
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/packages/show.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmHf"}

package/dist/commands/packages/show.js

@@ -52,18 +52,6 @@ export async function handleShow(packageName, options = {}) {
         console.log(`  Downloads: ${bundle.downloads.toLocaleString()}`);
         console.log(`  Published: ${new Date(bundle.published_at).toLocaleDateString()}`);
         console.log();
-        // GitHub info
-        if (bundle.github) {
-            console.log('GitHub:');
-            console.log(`  Repository: ${bundle.github.repo}`);
-            if (bundle.github.stars != null)
-                console.log(`  Stars: ${bundle.github.stars}`);
-            if (bundle.github.forks != null)
-                console.log(`  Forks: ${bundle.github.forks}`);
-            if (bundle.github.watchers != null)
-                console.log(`  Watchers: ${bundle.github.watchers}`);
-            console.log();
-        }
         // Tools
         if (bundle.tools && bundle.tools.length > 0) {
             console.log(`Tools (${bundle.tools.length}):`);

package/dist/commands/packages/show.js.map

@@ -1 +1 @@
-{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/packages/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAMlE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,UAAuB,EAAE;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAEpC,gDAAgD;QAChD,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/C,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC;YAC7B,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QAED,SAAS;QACT,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;QAE3G,cAAc;QACd,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,aAAa;QACb,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,kBAAkB;QAClB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,QAAQ;QACR,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,cAAc;QACd,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAChF,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAChF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzF,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,QAAQ;QACR,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,0BAA0B;QAC1B,IAAI,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3D,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,kBAAkB,EAAE,CAAC;gBACjE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;gBACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAEhD,mBAAmB;gBACnB,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvE,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAExF,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG,QAAQ,GAAG,OAAO,MAAM,IAAI,MAAM,SAAS,aAAa,gBAAgB,EAAE,CAAC,CAAC;YACjH,CAAC;YACD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,yCAAyC;QACzC,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;QAC3F,IAAI,aAAa,IAAI,aAAa,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,uBAAuB;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/packages/show.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,6 @@
 #!/usr/bin/env node
-import { config } from 'dotenv';
 import { createProgram } from './program.js';
 import { handleError } from './utils/errors.js';
-// Load environment variables from .env file
-config();
 async function main() {
     const program = createProgram();
     await program.parseAsync(process.argv);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,4CAA4C;AAC5C,MAAM,EAAE,CAAC;AAET,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC"}

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAgEvC"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAyEvC"}

package/dist/program.js

@@ -3,6 +3,7 @@ import { getVersion } from './utils/version.js';
 import { handleSearch } from './commands/packages/search.js';
 import { handleShow } from './commands/packages/show.js';
 import { handlePull } from './commands/packages/pull.js';
+import { handleRun } from './commands/packages/run.js';
 /**
  * Creates and configures the CLI program
  *
@@ -64,6 +65,14 @@ export function createProgram() {
         .action(async (packageSpec, options) => {
         await handlePull(packageSpec, options);
     });
+    // Run command
+    program
+        .command('run <package>')
+        .description('Run an MCP server from the registry (e.g., @scope/name or @scope/name@1.0.0)')
+        .option('--update', 'Force re-download even if cached')
+        .action(async (packageSpec, options) => {
+        await handleRun(packageSpec, options);
+    });
     return program;
 }
 //# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@nimblebrain/mpak",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.3",
   "description": "CLI for downloading MCPB bundles from the mpak registry",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "mpak": "./dist/index.js"
+    "mpak": "dist/index.js"
   },
   "scripts": {
     "build": "tsc",
@@ -15,10 +15,14 @@
     "lint:fix": "eslint src --fix",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
-    "test": "vitest",
+    "test": "vitest --run src",
+    "test:unit": "vitest --run src",
+    "test:integration": "vitest --run test/integration",
+    "test:all": "vitest --run",
+    "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --coverage",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc -p tsconfig.check.json"
   },
   "keywords": [
     "mcp",
@@ -29,9 +33,11 @@
   ],
   "author": "NimbleBrain Inc",
   "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
-    "commander": "^14.0.2",
-    "dotenv": "^17.2.3"
+    "commander": "^14.0.2"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
@@ -45,4 +51,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}

package/src/commands/packages/run.ts

@@ -0,0 +1,281 @@
+import { spawn, spawnSync } from 'child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { RegistryClient } from '../../lib/api/registry-client.js';
+
+export interface RunOptions {
+  update?: boolean;
+}
+
+interface McpConfig {
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+}
+
+interface McpbManifest {
+  manifest_version: string;
+  name: string;
+  version: string;
+  description: string;
+  server: {
+    type: 'node' | 'python' | 'binary';
+    entry_point: string;
+    mcp_config: McpConfig;
+  };
+}
+
+interface CacheMetadata {
+  version: string;
+  pulledAt: string;
+  platform: { os: string; arch: string };
+}
+
+/**
+ * Parse package specification into name and version
+ */
+function parsePackageSpec(spec: string): { name: string; version?: string } {
+  const lastAtIndex = spec.lastIndexOf('@');
+
+  if (lastAtIndex <= 0) {
+    return { name: spec };
+  }
+
+  const name = spec.substring(0, lastAtIndex);
+  const version = spec.substring(lastAtIndex + 1);
+
+  if (!name.startsWith('@')) {
+    return { name: spec };
+  }
+
+  return { name, version };
+}
+
+/**
+ * Get cache directory for a package
+ */
+function getCacheDir(packageName: string): string {
+  const cacheBase = join(homedir(), '.mpak', 'cache');
+  // @scope/name -> scope/name
+  const safeName = packageName.replace('@', '').replace('/', '-');
+  return join(cacheBase, safeName);
+}
+
+/**
+ * Read cache metadata
+ */
+function getCacheMetadata(cacheDir: string): CacheMetadata | null {
+  const metaPath = join(cacheDir, '.mpak-meta.json');
+  if (!existsSync(metaPath)) {
+    return null;
+  }
+  try {
+    return JSON.parse(readFileSync(metaPath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Write cache metadata
+ */
+function writeCacheMetadata(cacheDir: string, metadata: CacheMetadata): void {
+  const metaPath = join(cacheDir, '.mpak-meta.json');
+  writeFileSync(metaPath, JSON.stringify(metadata, null, 2));
+}
+
+/**
+ * Extract ZIP file to directory (simple implementation without external deps)
+ */
+async function extractZip(zipPath: string, destDir: string): Promise<void> {
+  // Use native unzip command (available on macOS, Linux, and Windows with WSL)
+  const { execSync } = await import('child_process');
+
+  // Ensure destination exists
+  mkdirSync(destDir, { recursive: true });
+
+  try {
+    execSync(`unzip -o -q "${zipPath}" -d "${destDir}"`, { stdio: 'pipe' });
+  } catch (error: any) {
+    throw new Error(`Failed to extract bundle: ${error.message}`);
+  }
+}
+
+/**
+ * Read manifest from extracted bundle
+ */
+function readManifest(cacheDir: string): McpbManifest {
+  const manifestPath = join(cacheDir, 'manifest.json');
+  if (!existsSync(manifestPath)) {
+    throw new Error(`Manifest not found in bundle: ${manifestPath}`);
+  }
+  return JSON.parse(readFileSync(manifestPath, 'utf8'));
+}
+
+/**
+ * Resolve placeholders in args (e.g., ${__dirname})
+ */
+function resolveArgs(args: string[], cacheDir: string): string[] {
+  return args.map(arg =>
+    arg.replace(/\$\{__dirname\}/g, cacheDir)
+  );
+}
+
+/**
+ * Find Python executable (tries python3 first, then python)
+ */
+function findPythonCommand(): string {
+  // Try python3 first (preferred on macOS/Linux)
+  const result = spawnSync('python3', ['--version'], { stdio: 'pipe' });
+  if (result.status === 0) {
+    return 'python3';
+  }
+  // Fall back to python
+  return 'python';
+}
+
+/**
+ * Run a package from the registry
+ */
+export async function handleRun(
+  packageSpec: string,
+  options: RunOptions = {}
+): Promise<void> {
+  const { name, version: requestedVersion } = parsePackageSpec(packageSpec);
+  const client = new RegistryClient();
+  const platform = RegistryClient.detectPlatform();
+  const cacheDir = getCacheDir(name);
+
+  let needsPull = true;
+  let cachedMeta = getCacheMetadata(cacheDir);
+
+  // Check if we have a cached version
+  if (cachedMeta && !options.update) {
+    if (requestedVersion) {
+      // Specific version requested - check if cached version matches
+      needsPull = cachedMeta.version !== requestedVersion;
+    } else {
+      // Latest requested - use cache (user can --update to refresh)
+      needsPull = false;
+    }
+  }
+
+  if (needsPull) {
+    // Fetch download info
+    const downloadInfo = await client.getDownloadInfo(name, requestedVersion, platform);
+    const bundle = downloadInfo.bundle;
+
+    // Check if cached version is already the latest
+    if (cachedMeta && cachedMeta.version === bundle.version && !options.update) {
+      needsPull = false;
+    }
+
+    if (needsPull) {
+      // Download to temp file
+      const tempPath = join(homedir(), '.mpak', 'tmp', `${Date.now()}.mcpb`);
+      mkdirSync(dirname(tempPath), { recursive: true });
+
+      process.stderr.write(`=> Pulling ${name}@${bundle.version}...\n`);
+      await client.downloadBundle(downloadInfo.url, tempPath);
+
+      // Clear old cache and extract
+      const { rmSync } = await import('fs');
+      if (existsSync(cacheDir)) {
+        rmSync(cacheDir, { recursive: true, force: true });
+      }
+      mkdirSync(cacheDir, { recursive: true });
+
+      await extractZip(tempPath, cacheDir);
+
+      // Write metadata
+      writeCacheMetadata(cacheDir, {
+        version: bundle.version,
+        pulledAt: new Date().toISOString(),
+        platform: bundle.platform,
+      });
+
+      // Cleanup temp file
+      rmSync(tempPath, { force: true });
+
+      process.stderr.write(`=> Cached ${name}@${bundle.version}\n`);
+    }
+  }
+
+  // Read manifest and execute
+  const manifest = readManifest(cacheDir);
+  const { type, entry_point, mcp_config } = manifest.server;
+
+  let command: string;
+  let args: string[];
+  let env: Record<string, string | undefined> = { ...process.env, ...mcp_config.env };
+
+  switch (type) {
+    case 'binary': {
+      // For binary, the entry_point is the executable path relative to bundle
+      command = join(cacheDir, entry_point);
+      args = resolveArgs(mcp_config.args || [], cacheDir);
+
+      // Ensure binary is executable
+      try {
+        chmodSync(command, 0o755);
+      } catch {
+        // Ignore chmod errors on Windows
+      }
+      break;
+    }
+
+    case 'node': {
+      command = mcp_config.command || 'node';
+      // Use mcp_config.args directly if provided, otherwise fall back to entry_point
+      if (mcp_config.args && mcp_config.args.length > 0) {
+        args = resolveArgs(mcp_config.args, cacheDir);
+      } else {
+        args = [join(cacheDir, entry_point)];
+      }
+      break;
+    }
+
+    case 'python': {
+      // Use manifest command if specified, otherwise auto-detect python
+      command = mcp_config.command === 'python' ? findPythonCommand() : (mcp_config.command || findPythonCommand());
+
+      // Use mcp_config.args directly if provided, otherwise fall back to entry_point
+      if (mcp_config.args && mcp_config.args.length > 0) {
+        args = resolveArgs(mcp_config.args, cacheDir);
+      } else {
+        args = [join(cacheDir, entry_point)];
+      }
+
+      // Set PYTHONPATH to deps/ directory for dependency resolution
+      const depsDir = join(cacheDir, 'deps');
+      const existingPythonPath = process.env.PYTHONPATH;
+      env.PYTHONPATH = existingPythonPath ? `${depsDir}:${existingPythonPath}` : depsDir;
+      break;
+    }
+
+    default:
+      throw new Error(`Unsupported server type: ${type}`);
+  }
+
+  // Spawn with stdio passthrough for MCP
+  const child = spawn(command, args, {
+    stdio: ['inherit', 'inherit', 'inherit'],
+    env,
+    cwd: cacheDir,
+  });
+
+  // Forward signals
+  process.on('SIGINT', () => child.kill('SIGINT'));
+  process.on('SIGTERM', () => child.kill('SIGTERM'));
+
+  // Wait for exit
+  child.on('exit', (code) => {
+    process.exit(code ?? 0);
+  });
+
+  child.on('error', (error) => {
+    process.stderr.write(`=> Failed to start server: ${error.message}\n`);
+    process.exit(1);
+  });
+}

package/src/commands/packages/show.ts

@@ -65,19 +65,9 @@ export async function handleShow(
     // Stats
     console.log('Statistics:');
     console.log(`  Downloads: ${bundle.downloads.toLocaleString()}`);
-    console.log(`  Published: ${new Date(bundle.published_at).toLocaleDateString()}`);
+    console.log(`  Published: ${new Date(bundle.published_at as string).toLocaleDateString()}`);
     console.log();
 
-    // GitHub info
-    if (bundle.github) {
-      console.log('GitHub:');
-      console.log(`  Repository: ${bundle.github.repo}`);
-      if (bundle.github.stars != null) console.log(`  Stars: ${bundle.github.stars}`);
-      if (bundle.github.forks != null) console.log(`  Forks: ${bundle.github.forks}`);
-      if (bundle.github.watchers != null) console.log(`  Watchers: ${bundle.github.watchers}`);
-      console.log();
-    }
-
     // Tools
     if (bundle.tools && bundle.tools.length > 0) {
       console.log(`Tools (${bundle.tools.length}):`);
@@ -95,7 +85,7 @@ export async function handleShow(
       console.log(`Versions (${versionsInfo.versions.length}):`);
       const recentVersions = versionsInfo.versions.slice(0, 5);
       for (const version of recentVersions) {
-        const date = new Date(version.published_at).toLocaleDateString();
+        const date = new Date(version.published_at as string).toLocaleDateString();
         const downloads = version.downloads.toLocaleString();
         const isLatest = version.version === versionsInfo.latest ? ' (latest)' : '';
         const provTag = version.provenance ? ' 🔒' : '';

package/src/index.ts

@@ -1,12 +1,8 @@
 #!/usr/bin/env node
 
-import { config } from 'dotenv';
 import { createProgram } from './program.js';
 import { handleError } from './utils/errors.js';
 
-// Load environment variables from .env file
-config();
-
 async function main() {
   const program = createProgram();
   await program.parseAsync(process.argv);

package/src/lib/api/schema.d.ts

@@ -51,8 +51,7 @@ export interface paths {
                                     description?: string;
                                 }[];
                                 downloads: number;
-                                /** Format: date-time */
-                                published_at: string;
+                                published_at: string | unknown;
                                 verified: boolean;
                                 provenance?: {
                                     schema_version: string;
@@ -121,27 +120,19 @@ export interface paths {
                                 description?: string;
                             }[];
                             downloads: number;
-                            /** Format: date-time */
-                            published_at: string;
+                            published_at: string | unknown;
                             verified: boolean;
-                            homepage?: string | null;
-                            license?: string | null;
-                            github?: {
-                                repo: string;
-                                stars?: number | null;
-                                forks?: number | null;
-                                watchers?: number | null;
-                            } | null;
                             provenance?: {
                                 schema_version: string;
                                 provider: string;
                                 repository: string;
                                 sha: string;
                             } | null;
+                            homepage?: string | null;
+                            license?: string | null;
                             versions: {
                                 version: string;
-                                /** Format: date-time */
-                                published_at: string;
+                                published_at: string | unknown;
                                 downloads: number;
                             }[];
                         };
@@ -188,15 +179,13 @@ export interface paths {
                             mimeType: string;
                             name: string;
                             version: string;
-                            description?: string | null;
+                            description: string | null;
                             bundles: {
-                                mimeType: string;
+                                mimeType: string | null;
                                 digest: string;
                                 size: number;
                                 platform: {
-                                    /** @description Operating system (darwin, linux, win32, any) */
                                     os: string;
-                                    /** @description Architecture (x64, arm64, any) */
                                     arch: string;
                                 };
                                 urls: string[];
@@ -250,15 +239,12 @@ export interface paths {
                                 version: string;
                                 artifacts_count: number;
                                 platforms: {
-                                    /** @description Operating system (darwin, linux, win32, any) */
                                     os: string;
-                                    /** @description Architecture (x64, arm64, any) */
                                     arch: string;
                                 }[];
-                                /** Format: date-time */
-                                published_at: string;
+                                published_at: string | unknown;
                                 downloads: number;
-                                publish_method?: string | null;
+                                publish_method: string | null;
                                 provenance?: {
                                     schema_version: string;
                                     provider: string;
@@ -309,14 +295,11 @@ export interface paths {
                         "application/json": {
                             name: string;
                             version: string;
-                            /** Format: date-time */
-                            published_at: string;
+                            published_at: string | unknown;
                             downloads: number;
                             artifacts: {
                                 platform: {
-                                    /** @description Operating system (darwin, linux, win32, any) */
                                     os: string;
-                                    /** @description Architecture (x64, arm64, any) */
                                     arch: string;
                                 };
                                 digest: string;
@@ -324,16 +307,19 @@ export interface paths {
                                 download_url: string;
                                 source_url?: string;
                             }[];
-                            manifest?: {
+                            manifest: {
                                 [key: string]: unknown;
                             };
                             release?: {
-                                tag?: string;
-                                url?: string;
-                            } | null;
-                            publish_method?: string | null;
-                            provenance?: {
-                                [key: string]: unknown;
+                                tag: string | null;
+                                url: string | null;
+                            };
+                            publish_method: string | null;
+                            provenance: {
+                                schema_version: string;
+                                provider: string;
+                                repository: string;
+                                sha: string;
                             } | null;
                         };
                     };
@@ -386,16 +372,13 @@ export interface paths {
                                 name: string;
                                 version: string;
                                 platform: {
-                                    /** @description Operating system (darwin, linux, win32, any) */
                                     os: string;
-                                    /** @description Architecture (x64, arm64, any) */
                                     arch: string;
                                 };
                                 sha256: string;
                                 size: number;
                             };
-                            /** Format: date-time */
-                            expires_at: string;
+                            expires_at?: string;
                         };
                     };
                 };
@@ -425,7 +408,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Announce a new bundle version from a GitHub release (OIDC only) */
+        /** @description Announce a single artifact for a bundle version from a GitHub release (OIDC only). Idempotent - can be called multiple times for different artifacts of the same version. */
         post: {
             parameters: {
                 query?: never;
@@ -436,14 +419,21 @@ export interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description Package name (@scope/name) */
                         name: string;
-                        /** @description Semantic version */
                         version: string;
-                        /** @description Bundle manifest */
-                        manifest: Record<string, never>;
-                        /** @description GitHub release tag (e.g., v0.1.0) */
+                        manifest: {
+                            [key: string]: unknown;
+                        };
                         release_tag: string;
+                        /** @default false */
+                        prerelease: boolean;
+                        artifact: {
+                            filename: string;
+                            os: string;
+                            arch: string;
+                            sha256: string;
+                            size: number;
+                        };
                     };
                 };
             };
@@ -455,34 +445,16 @@ export interface paths {
                     };
                     content: {
                         "application/json": {
-                            success: boolean;
-                            bundle: {
-                                name: string;
-                                version: string;
-                                artifacts_count: number;
-                            };
-                            release: {
-                                tag: string;
-                                url: string;
+                            package: string;
+                            version: string;
+                            artifact: {
+                                os: string;
+                                arch: string;
+                                filename: string;
                             };
-                            artifacts: {
-                                platform: {
-                                    /** @description Operating system (darwin, linux, win32, any) */
-                                    os: string;
-                                    /** @description Architecture (x64, arm64, any) */
-                                    arch: string;
-                                };
-                                digest: string;
-                                size: number;
-                                url: string;
-                                source_url: string;
-                            }[];
-                            provenance: {
-                                schema_version: string;
-                                provider: string;
-                                repository: string;
-                                sha: string;
-                            } | null;
+                            total_artifacts: number;
+                            /** @enum {string} */
+                            status: "created" | "updated";
                         };
                     };
                 };

package/src/program.ts

@@ -3,6 +3,7 @@ import { getVersion } from './utils/version.js';
 import { handleSearch } from './commands/packages/search.js';
 import { handleShow } from './commands/packages/show.js';
 import { handlePull } from './commands/packages/pull.js';
+import { handleRun } from './commands/packages/run.js';
 
 /**
  * Creates and configures the CLI program
@@ -72,5 +73,14 @@ export function createProgram(): Command {
       await handlePull(packageSpec, options);
     });
 
+  // Run command
+  program
+    .command('run <package>')
+    .description('Run an MCP server from the registry (e.g., @scope/name or @scope/name@1.0.0)')
+    .option('--update', 'Force re-download even if cached')
+    .action(async (packageSpec, options) => {
+      await handleRun(packageSpec, options);
+    });
+
   return program;
 }

package/test/integration/registry-client.test.ts

@@ -0,0 +1,180 @@
+import { describe, it, expect, afterAll } from 'vitest';
+import { RegistryClient } from '../../src/lib/api/registry-client.js';
+import * as fs from 'fs';
+import * as path from 'path';
+
+/**
+ * Integration tests for the mpak registry client
+ *
+ * These tests hit the live api.mpak.dev registry using the @nimblebraininc/echo
+ * bundle as a known fixture. They verify the full flow from search to download.
+ *
+ * Run with: npm run test:integration
+ */
+describe('RegistryClient Integration', () => {
+  const client = new RegistryClient();
+  const testBundle = '@nimblebraininc/echo';
+  const downloadedFiles: string[] = [];
+
+  afterAll(() => {
+    // Clean up any downloaded files
+    for (const file of downloadedFiles) {
+      if (fs.existsSync(file)) {
+        fs.unlinkSync(file);
+      }
+    }
+  });
+
+  describe('searchBundles', () => {
+    it('should find echo bundle when searching for "echo"', async () => {
+      const result = await client.searchBundles('echo');
+
+      expect(result.bundles).toBeDefined();
+      expect(result.bundles.length).toBeGreaterThan(0);
+
+      const echoBundle = result.bundles.find(b => b.name === testBundle);
+      expect(echoBundle).toBeDefined();
+      expect(echoBundle?.description).toContain('Echo');
+    });
+
+    it('should return empty results for nonsense query', async () => {
+      const result = await client.searchBundles('xyznonexistent12345');
+
+      expect(result.bundles).toBeDefined();
+      expect(result.bundles.length).toBe(0);
+    });
+
+    it('should respect limit parameter', async () => {
+      const result = await client.searchBundles('', { limit: 1 });
+
+      expect(result.bundles.length).toBeLessThanOrEqual(1);
+    });
+  });
+
+  describe('getBundle', () => {
+    it('should return bundle details for @nimblebraininc/echo', async () => {
+      const bundle = await client.getBundle(testBundle);
+
+      expect(bundle.name).toBe(testBundle);
+      expect(bundle.description).toBeDefined();
+      expect(bundle.server_type).toBe('python');
+      expect(bundle.author).toBeDefined();
+      expect(bundle.latest_version).toBeDefined();
+    });
+
+    it('should include provenance information', async () => {
+      const bundle = await client.getBundle(testBundle);
+
+      expect(bundle.provenance).toBeDefined();
+      expect(bundle.provenance?.provider).toBe('github_oidc');
+      expect(bundle.provenance?.repository).toContain('mcp-echo');
+    });
+
+    it('should throw error for non-existent bundle', async () => {
+      await expect(
+        client.getBundle('@nonexistent/bundle-xyz')
+      ).rejects.toThrow('Bundle not found');
+    });
+
+    it('should throw error for unscoped package name', async () => {
+      await expect(
+        client.getBundle('unscoped-name')
+      ).rejects.toThrow('Package name must be scoped');
+    });
+  });
+
+  describe('getVersions', () => {
+    it('should return version list with platforms', async () => {
+      const result = await client.getVersions(testBundle);
+
+      expect(result.versions).toBeDefined();
+      expect(result.versions.length).toBeGreaterThan(0);
+
+      const latestVersion = result.versions[0];
+      expect(latestVersion.version).toBeDefined();
+      expect(latestVersion.platforms).toBeDefined();
+      expect(latestVersion.platforms.length).toBeGreaterThan(0);
+    });
+
+    it('should include linux platforms for echo bundle', async () => {
+      const result = await client.getVersions(testBundle);
+
+      const latestVersion = result.versions[0];
+      const platforms = latestVersion.platforms.map(p => `${p.os}-${p.arch}`);
+
+      expect(platforms).toContain('linux-x64');
+      expect(platforms).toContain('linux-arm64');
+    });
+  });
+
+  describe('getDownloadInfo', () => {
+    it('should return download URL for latest version', async () => {
+      const info = await client.getDownloadInfo(testBundle, undefined, {
+        os: 'linux',
+        arch: 'x64',
+      });
+
+      expect(info.url).toBeDefined();
+      expect(info.url).toMatch(/^https?:\/\//);
+      expect(info.bundle.version).toBeDefined();
+      expect(info.bundle.platform).toBeDefined();
+      expect(info.bundle.size).toBeGreaterThan(0);
+      expect(info.bundle.sha256).toBeDefined();
+    });
+
+    it('should return correct artifact for requested platform', async () => {
+      const info = await client.getDownloadInfo(testBundle, undefined, {
+        os: 'linux',
+        arch: 'arm64',
+      });
+
+      expect(info.bundle.platform.os).toBe('linux');
+      expect(info.bundle.platform.arch).toBe('arm64');
+    });
+
+    it('should return download info for specific version', async () => {
+      const versions = await client.getVersions(testBundle);
+      const specificVersion = versions.versions[0].version;
+
+      const info = await client.getDownloadInfo(testBundle, specificVersion, {
+        os: 'linux',
+        arch: 'x64',
+      });
+
+      expect(info.bundle.version).toBe(specificVersion);
+    });
+  });
+
+  describe('downloadBundle', () => {
+    it('should download bundle file successfully', async () => {
+      const info = await client.getDownloadInfo(testBundle, undefined, {
+        os: 'linux',
+        arch: 'x64',
+      });
+
+      const outputPath = path.join(
+        process.cwd(),
+        `test-download-${Date.now()}.mcpb`
+      );
+      downloadedFiles.push(outputPath);
+
+      await client.downloadBundle(info.url, outputPath);
+
+      expect(fs.existsSync(outputPath)).toBe(true);
+
+      const stats = fs.statSync(outputPath);
+      expect(stats.size).toBe(info.bundle.size);
+    }, 60000); // 60s timeout for download
+  });
+
+  describe('detectPlatform', () => {
+    it('should return valid platform object', () => {
+      const platform = RegistryClient.detectPlatform();
+
+      expect(platform.os).toBeDefined();
+      expect(platform.arch).toBeDefined();
+      expect(['darwin', 'linux', 'win32', 'any']).toContain(platform.os);
+      expect(['x64', 'arm64', 'any']).toContain(platform.arch);
+    });
+  });
+});

package/tsconfig.check.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "noEmit": true
+  },
+  "include": ["src/**/*", "test/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -4,10 +4,11 @@ export default defineConfig({
   test: {
     globals: true,
     environment: 'node',
+    include: ['src/**/*.test.ts', 'test/**/*.test.ts'],
     coverage: {
       provider: 'v8',
       reporter: ['text', 'json', 'html'],
-      exclude: ['dist', 'node_modules', '**/*.test.ts', '**/*.config.ts'],
+      exclude: ['dist', 'node_modules', '**/*.test.ts', '**/*.config.ts', 'test'],
     },
   },
 });