How do I install MCP Gearbox MCP Server?

Follow the setup instructions on the MCP Gearbox GitHub repository, then add the server configuration to your AI client.

What category is MCP Gearbox MCP Server?

MCP Gearbox is categorized under Developer Tools. Browse more servers in these categories on MCPgee.

MCP Gearbox

Name: Mcp Gearbox MCP Server
Author: rohitsoni007

v1.0.0•Developer Tools•stable

A modern desktop application for managing Model Context Protocol (MCP) servers across multiple AI agents

aiai-agentsai-toolsclaude-codedesktop-app

Stars

Downloads

Weekly

0/5

View on GitHub

What is MCP Gearbox?

MCP Gearbox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to modern desktop application for managing model context protocol (mcp) servers across multiple ai agents

A modern desktop application for managing Model Context Protocol (MCP) servers across multiple AI agents

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

A modern desktop application for managing Model Context Prot

Use Cases

Desktop MCP server management

Multi-agent orchestration across platforms

rohitsoni007

Maintainer

LicenseMIT

Languagetypescript

Versionv1.0.0

UpdatedMay 3, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx mcp-gearbox

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use MCP Gearbox

MCP Gearbox is a cross-platform desktop application (Electron) that provides a graphical interface for discovering, installing, configuring, and managing Model Context Protocol servers across more than ten AI coding agents — including Claude Code, GitHub Copilot, Cursor, Continue, Kiro, and LM Studio. It eliminates the need to manually edit JSON config files for each agent, offering one-click server installation, enable/disable toggling, and automatic settings persistence. It is especially useful for teams or individual developers who work across multiple AI tools and want a single control panel for their MCP ecosystem.

Prerequisites

Node.js 18 or later and npm installed
Python 3.11 or later installed
uv package manager installed (https://github.com/astral-sh/uv)
Git installed
At least one supported AI agent installed (Claude Code, Cursor, Copilot, etc.)

Download a pre-built binary or clone the source

Pre-built installers are available on the GitHub releases page for Windows (.exe), macOS (.dmg for Intel and Apple Silicon), and Linux (.deb/.rpm). Alternatively, clone the source to build from scratch.

# To build from source:
git clone https://github.com/rohitsoni007/mcp-gearbox.git
cd mcp-gearbox

Install dependencies

Install npm dependencies. The build system relies on Electron Forge for packaging.

npm install

Run in development mode or build a production binary

Use 'npm start' to launch in development mode immediately, or 'npm run make' to produce a distributable installer for your platform.

# Development:
npm start

# Production build:
npm run make

Open MCP Gearbox and connect your AI agents

Launch the application. It auto-detects installed AI agents (Claude Code, Cursor, Copilot, etc.) on your machine. Select the agent(s) you want to manage and proceed to the server discovery screen.

Browse and install MCP servers

Use the built-in search to find community MCP servers. Click 'Install' next to any server — Gearbox writes the correct configuration to the agent's config file and restarts or reloads it if needed.

Enable, disable, or remove servers

Toggle servers on/off per agent using the UI switches. Remove a server to clean up its config entry. All changes are saved automatically via Redux Persist.

MCP Gearbox Examples

Typical workflow

MCP Gearbox is a GUI desktop app, not a server with a JSON config entry. The typical workflow is to launch the app and use the interface to manage MCP servers for your agents. Below is a summary of what a session looks like.

1. Launch MCP Gearbox (app or npm start)
2. App detects: Claude Code, Cursor, GitHub Copilot
3. Search for "filesystem" MCP server
4. Click Install → selects agents to add it to
5. Server appears in each agent's MCP config automatically
6. Toggle off a server for a specific agent without removing it globally

Prompts to try after installing servers via Gearbox

Once Gearbox has configured MCP servers in your agents, use these prompts in Claude Code or Cursor.

- "List all MCP servers currently installed in my Claude Code configuration."
- "Which MCP servers are enabled for Cursor but not for Claude Code?"
- "Install the GitHub MCP server and enable it for all my agents."
- "Disable the filesystem MCP server only for GitHub Copilot."

Troubleshooting MCP Gearbox

MCP Gearbox does not detect an installed AI agent

Ensure the agent's config file exists at its default location (e.g., ~/Library/Application Support/Claude/ for Claude Desktop on macOS). Gearbox reads known paths — if you installed an agent to a non-standard location it may not be found automatically.

Build fails with 'python not found' or 'uv not found' errors

Install Python 3.11+ and the uv package manager (curl -LsSf https://astral.sh/uv/install.sh | sh). Some MCP servers managed by Gearbox use uvx for installation, so both must be on the PATH.

Settings are not persisted between app restarts

Gearbox uses Electron's userData directory for Redux Persist storage. Check that the app has write permission to ~/Library/Application Support/mcp-gearbox (macOS) or %APPDATA%/mcp-gearbox (Windows).

Frequently Asked Questions about MCP Gearbox

What is MCP Gearbox?

MCP Gearbox is a Model Context Protocol (MCP) server that modern desktop application for managing model context protocol (mcp) servers across multiple ai agents It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Gearbox?

Follow the installation instructions on the MCP Gearbox GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Gearbox?

MCP Gearbox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Gearbox free to use?

Yes, MCP Gearbox is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

MCP Gearbox Alternatives — Similar Developer Tools Servers

Looking for alternatives to MCP Gearbox? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer Tools Browse All Servers

Set Up MCP Gearbox in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "mcp-gearbox": {
      "command": "npx",
      "args": ["-y", "mcp-gearbox"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Gearbox?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides