mcp-gearbox-js

MCP Gearbox - Node.js Wrapper provides a convenient Node-based interface to the MCP Gearbox CLI (originally a Python tool). This wrapper lets you install and run the Gearbox tooling via npm, automatically detecting the required runtime (uv/Python) and invoking the Python CLI under the hood when needed. Once installed globally, you can start using the wrapper to install, configure, and manage gearboxes and related MCP components through a familiar Node.js environment. The wrapper mirrors the functionality of the Gearbox CLI but exposes it through a Node.js entry point, making automation, scripting, and integration with other Node-based tools straightforward. This is especially useful for developers who want to incorporate MCP Gearbox operations into build pipelines, deployment scripts, or custom tooling.

Prerequisites:

• Node.js 20.0.0 or higher
• uv or Python 3.11+ (the installer detects this automatically)
• Git (for installation from source if needed)

Installation steps:

1. Install the package globally with npm:

npm install -g mcp-gearbox

2. Verify installation by checking the version or help command (adjust for your CLI wrapper if provided):

mcp-gearbox --version
mcp-gearbox --help

3. Ensure prerequisites are available on your system. The wrapper will attempt to detect uv (Node.js native bindings) or Python 3.11+ and will fall back as needed to run the underlying Gearbox CLI.

4. If you need to install from source, clone the repository and install dependencies as documented in the repository, then link or run the package locally.

Tips and notes:

• The wrapper relies on the MCP Gearbox CLI (Python-based). If Python/uv is not present, the installer will attempt to detect or install it where possible.
• Ensure Git is available if you plan to install from source or contribute.
• If you encounter path or permission issues on Unix-like systems, you may need to prepend sudo to the install commands or adjust file permissions for global npm modules.
• The environment variable GEARBOX_CLI can be used to toggle behavior related to the underlying Gearbox CLI during execution.
• This wrapper is intended to simplify automation; for advanced usage, consult the official Gearbox CLI documentation and adapt the commands in your scripts accordingly.