# 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 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 # 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 # Install a specific package mcpm i # Short alias for install mcpm install -y # Install without confirmation ``` ### Remove a MCP server Remove a MCP server from Claude App: ```bash mcpm remove # Interactive mode mcpm remove # Remove a specific server mcpm rm # 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 # 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 # 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 ```