mcpm - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #typescript #llm #rust #deep-learning #nodejs #macos #cli #security #mcp #ios #openai #open-source

mcpm

(★ 107)

A command-line tool for managing MCP servers in Claude App. Also can run a MCP Server to help you manage all your MCP Servers

File Explorer

Download Latest Version (.zip)

- - bug_report.md
  - feature_request.md
- - release.yml
  - test.yml
- PULL_REQUEST_TEMPLATE.md
- .gitignore
- pre-commit
- prepare-commit-msg
- launch.json
- settings.json
- index.js
- MCP.md
- - cli.test.ts
  - setup.ts
- - formatter.ts
  - logger.ts
  - version.ts
- cli.ts
.env
.eslintignore
.eslintrc.cjs
.gitattributes
.gitignore
.npmignore
.prettierrc
babel.config.cjs
jest.config.cjs
LICENSE
package.json
pnpm-lock.yaml
README.md
README.zh.md
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/MCP-Club/mcpm

Downloads the entire project code from GitHub to your computer.

cd mcpm

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Node.js Node.js must be installed to use npm.

npm install -g @mcpm/cli

Installs the package published on the npm registry globally — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install -g @mcpm/cli

Installs the package published on the npm registry globally — no need to clone the source.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MCPM CLI

[![npm version](https://img.shields.io/npm/v/@mcpm/cli.svg)](https://www.npmjs.com/package/@mcpm/cli)
[![npm downloads](https://img.shields.io/npm/dm/@mcpm/cli.svg)](https://www.npmjs.com/package/@mcpm/cli)
[![Build Status](https://github.com/MCP-Club/mcpm/actions/workflows/test.yml/badge.svg)](https://github.com/MCP-Club/mcpm/actions)
[![GitHub license](https://img.shields.io/github/license/MCP-Club/mcpm.svg)](https://github.com/MCP-Club/mcpm/blob/main/LICENSE)
[![GitHub issues](https://img.shields.io/github/issues/MCP-Club/mcpm.svg)](https://github.com/MCP-Club/mcpm/issues)
[![GitHub stars](https://img.shields.io/github/stars/MCP-Club/mcpm.svg)](https://github.com/MCP-Club/mcpm/stargazers)

A command-line tool for managing MCP servers in Claude App.

## Highlights

- 🚀 **Easy Server Management**: Add, remove, and manage multiple MCP servers in Claude App with simple commands
- 🔄 **Server Status Control**: Enable/disable servers and view their status at any time
- 🛠️ **Interactive CLI**: User-friendly command-line interface with interactive prompts for easy configuration
- 🔌 **Self-Integration**: Can add MCPM CLI itself as a MCP server with a single command
- 📝 **JSON Configuration**: Manages servers through Claude's configuration file with proper error handling
- 🔍 **Package Discovery**: Search and discover MCP packages from the community

## RoadMap

- [x] Add Remote MCP Discovery (A MCPHub for search and recommendation)
- [x] Auto Install MCP Servers For you
- [ ] A GUI for MCPM CLI

## Installation

```bash
npm install -g @mcpm/cli
```

## Usage

```bash

> mcpm help

Usage: mcpm [options] [command]

Options:
  -V, --version         output the version number
  -d, --debug           enables verbose logging (default: false)
  -h, --help            display help for command

Commands:
  search [query]        Search for MCP packages
  install <n>           Install a MCP package from the registry
  add [options] [name]  Manually add a new MCP server to your Claude App
  remove [name]         Remove a MCP server from your Claude App
  disable [name]        Disable an MCP server (moves it from Claude to storage)
  enable [name]         Enable a disabled MCP server (moves it from storage to Claude)
  list [options]        List all your MCP servers
  mcp                   Start the MCPM MCP server
  restart               Restart Claude.app
  help [command]        display help for command

```

### Search for MCP packages

Search for available MCP packages in the registry:

```bash
mcpm search              # Interactive search mode
mcpm search <query>      # Search with a specific query
mcpm search --json       # Output results in JSON format
```

### Install a MCP package

Install a MCP package by its ID:

```bash
mcpm install <package-id>     # Install a specific package
mcpm i <package-id>          # Short alias for install
mcpm install -y <package-id>  # Install without confirmation
```

### Remove a MCP server

Remove a MCP server from Claude App:

```bash
mcpm remove                 # Interactive mode
mcpm remove <name>          # Remove a specific server
mcpm rm <name>              # Short alias for remove
```

### Disable an MCP server

Moves a server from Claude App to storage, making it temporarily unavailable.

```bash
mcpm disable               # Interactive mode
mcpm disable <name>        # Specify server name
```

### Enable an MCP server

Moves a previously disabled server from storage back to Claude App.

```bash
mcpm enable               # Interactive mode
mcpm enable <name>        # Specify server name
```

### List MCP servers

```bash
mcpm list            # Shows all configured MCP servers
```

### Start As A MCP Server

```bash
mcpm mcp               # Start MCPM as a MCP server
```

For more information, visit our [MCP.md](./docs/MCP.md).

### Add itself as a MCP server to your Claude App

```bash
mcpm add --self          # Add MCPM CLI as a MCP server
```

## Configuration

- Active servers are stored in Claude App's configuration
- Disabled servers are stored in `~/.mcpm/*`

## Development

### Publish A new version

GitHub Actions will automatically publish a new version when a new tag is created

```bash
git tag v1.4.1
git push origin v1.4.1
```