MCP Gearbox - Node.js Wrapper

A Node.js wrapper for the MCP Gearbox CLI Python CLI tool, allowing easy installation and usage via npm.

Installation

npm install -g mcp-gearbox

Prerequisites

• Node.js 20.0.0 or higher
• uv or Python 3.11+ (automatically detected during installation)
• Git (for installation from source)

Usage

After installation, you can use the CLI commands directly:

# Interactive MCP server selection
mcp init

# Configure for specific AI agent
mcp init -a copilot
mcp init -a continue
mcp init -a kiro
mcp init -a cursor
mcp init -a qoder
mcp init -a claude
mcp init -a gemini
mcp init -a lmstudio

# Initialize in current directory
mcp init .

# Initialize in specific directory
mcp init my-project -a kiro

How it works

This Node.js wrapper:

1. Installation: Automatically installs the Python mcp-cli package using uv (preferred) or pip (fallback)
2. Execution: Provides mcp-cli and mcp commands that proxy to the Python implementation
3. Cross-platform: Works on Windows, macOS, and Linux

Programmatic Usage

You can also use this package programmatically in your Node.js applications:

const { executeMcpCli, isMcpCliInstalled } = require('mcp-gearbox');

async function example() {
  // Check if mcp-cli is installed
  const isInstalled = await isMcpCliInstalled();
  console.log('MCP Gearbox installed:', isInstalled);

  // Execute mcp-cli command
  const result = await executeMcpCli(['init', '.', '-a', 'kiro']);
  console.log('Exit code:', result.code);
}

TypeScript Support

import { executeMcpCli, isMcpCliInstalled, ExecutionResult } from 'mcp-gearbox';

async function example(): Promise<void> {
  const isInstalled: boolean = await isMcpCliInstalled();
  console.log('MCP Gearbox installed:', isInstalled);

  const result: ExecutionResult = await executeMcpCli(['init', '.', '-a', 'kiro']);
  console.log('Exit code:', result.code);
}

Troubleshooting

Python not found

If you get a "Python not found" error:

1. Install Python 3.11+ from python.org
2. Ensure Python is in your PATH
3. Try reinstalling: npm uninstall -g mcp-gearbox && npm install -g mcp-gearbox

Installation fails

If the automatic installation fails:

1. Install manually: pip install git+https://github.com/rohitsoni007/mcp-gearbox-cli
2. Or use uv: uv tool install mcp-gearbox --force --from git+https://github.com/rohitsoni007/mcp-gearbox-cli

Supported AI Agents

• GitHub Copilot
• Continue
• Kiro
• Cursor
• Claude Code
• Gemini CLI
• Qoder
• LM Studio

License

MIT - See the main MCP Gearbox CLI repository for details.

Links

• Main Repository
• Issues