@mcp-sandbox/cli NPM

@mcp-sandbox/cli

Command-line interface for MCP Sandbox - turn any JavaScript module into a sandboxed MCP (Model Context Protocol) server.

🚀 Installation

# Global installation
npm install -g @mcp-sandbox/cli

# Local installation
npm install @mcp-sandbox/cli

📋 Commands

`start`

Start an MCP server for a JavaScript module.

mcp-sandbox start <module> [options]

Options:
  -p, --port <port>      Server port (default: 3000)
  -h, --host <host>      Server host (default: localhost)
  -t, --timeout <ms>     Execution timeout (default: 5000ms)
  -o, --output <file>    Output MCP configuration to file

`inspect`

Analyze a module without starting the server.

mcp-sandbox inspect <module> [options]

Options:
  -o, --output <file>    Output analysis report to file

`generate`

Generate MCP configuration for a module.

mcp-sandbox generate <module> [options]

Options:
  -o, --output <file>    Output file (default: mcp-config.json)

💡 Examples

# Start server for local module
mcp-sandbox start ./utils.js --port 8080

# Analyze npm package
mcp-sandbox inspect lodash --output analysis.json

# Generate config for module
mcp-sandbox generate ./my-tools.js --output tools-config.json

# Start server with custom configuration
mcp-sandbox start ./math-utils.js --host 0.0.0.0 --timeout 10000

🏗️ Example Module

Create a simple utilities module:

// my-utils.js

/**
 * Calculate the area of a circle
 * @param radius The radius of the circle
 */
function circleArea(radius = 1) {
  return Math.PI * radius * radius;
}

/**
 * Generate a random string
 * @param length Length of the string
 * @param includeNumbers Include numbers in the string
 */
function randomString(length = 10, includeNumbers = true) {
  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
  const numbers = '0123456789';
  const pool = includeNumbers ? chars + numbers : chars;

  let result = '';
  for (let i = 0; i < length; i++) {
    result += pool.charAt(Math.floor(Math.random() * pool.length));
  }
  return result;
}

module.exports = { circleArea, randomString };

Then start the MCP server:

mcp-sandbox start my-utils.js

🎮 Testing Your Server

Start the server: mcp-sandbox start my-utils.js

Test with curl:

# List available tools
curl http://localhost:3000/tools

# Execute a function
curl -X POST http://localhost:3000/execute/circleArea \
  -H "Content-Type: application/json" \
  -d '{"args": {"radius": 5}}'