# MCP Bar

Your all-in-one CLI manager for MCP servers and home to an open registry with 1500+ ready-to-use servers. Install, manage, and discover AI tools effortlessly.

## 🧩 MCP Manifest Concept

MCPBar implements a standardized approach for MCP servers using `mcp.json` manifest files. This solution:

- 📄 Uses a **standardized manifest format** (`mcp.json`) similar to `package.json` in npm
- 🌐 Supports a **decentralized distribution model** where developers can host manifests anywhere
- 🔄 Allows installation directly from URLs, local files, or package aliases
- 🔍 Features an optional registry for enhanced discoverability
- 🔐 Securely handles server configuration with explicit handling of sensitive inputs
- 📚 Includes an **open registry** with 1500+ MCP servers in the `registry` directory
- 🐳 Supports multiple runtime options including `npx`, `uvx` and `docker`

This approach simplifies discovery, installation, and configuration of MCP servers across different clients, making the MCP ecosystem more accessible and organized.

The extensive registry is the foundation of an open and standardized MCP ecosystem, enabling developers to easily discover, share, and contribute to the growing collection of MCP servers.

For more details, see the [MCP Manifest Proposal](./doc/proposal.md) and [Concept Overview](./doc/idea.md).

## 🌟 Features

- 🔄 Simple installation and management of MCP servers
- 🛠️ User-friendly command-line interface with interactive prompts for easy configuration
- 📱 Works cross-platform including Windows, macOS, and Linux
- 🔍 Search, install, disable, and enable MCP servers with ease
- 🔌 Supports multiple MCP clients including Claude, Cline, Cursor, Windsurf, Witsy, and more

## 📦 Installation

```sh
npm install -g mcpbar
```

## 🔧 Usage

### Basic Commands

```sh
# 🔍 Install a server
mcpbar install ./manifests/github.json

# 🗑️ Remove a server
mcpbar remove playwright # remove playwright server

# 📋 List installed servers
mcpbar list # show existing mcp servers installed on the device
```

### Search for MCP Servers

Search for available MCP packages in the registry:

```bash
mcpbar search <query>        # Search for MCP servers and opens in your browser
mcpbar s <query>             # Short alias for search
```

### Install a MCP Server

Install a MCP server from a URL (any protocol supported by fetch), file path, or package alias:

```bash
mcpbar install <path-to-manifest.json>  # Install from local manifest file
mcpbar i <path-to-manifest.json>        # Short alias for install
mcpbar install https://example.com/manifest.json  # Install from HTTP URL
mcpbar install file:///path/to/manifest.json     # Install using file protocol
mcpbar install vendor/package-name      # Install using package alias
```

Example:

```bash
# Install from a local manifest file
mcpbar install ./manifests/github.json

# Install using package alias (shorthand)
mcpbar i 21st-dev/magic-mcp

# Install from a URL
mcpbar install https://esm.sh/gh/in-fun/mcpbar/registry/21st-dev/magic-mcp.json

# Install using file protocol
mcpbar install file:///Users/username/projects/manifests/custom.json
```

### Remove a MCP Server

Remove a MCP server:

```bash
mcpbar remove <name>         # Remove a specific server
mcpbar rm <name>             # Short alias for remove
```

### List MCP Servers

View all your configured MCP servers:

```bash
mcpbar list
# Or use the short alias
mcpbar ls
```

### Edit MCP Client Configuration

Open the configuration file for an MCP client directly in your default editor:

```bash
mcpbar edit              # Edit configuration for the default client (claude)
mcpbar edit --client cursor  # Edit configuration for a specific client
mcpbar e --client witsy      # Short alias for edit
```

If the configuration file doesn't exist, the command will offer to create an empty file for you.

### Start an MCP Server

Run a MCP server on standalone mode.

```bash
mcpbar start <name>
# Or use the alias
mcpbar s <name>
```

## 📋 Example Workflow

```bash
# Search for available servers
mcpbar search playwright

# Install the server you want
mcpbar install playwright

# Verify installation
mcpbar list
```

## License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.