v2.0.0 · MIT License · Node ≥ 20

mcpman

The package manager for MCP servers.

Install, manage, and inspect Model Context Protocol servers across all your AI clients — Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Roo Code, Codex CLI, OpenCode, Continue, and Zed — from a single CLI.

Try it now
$ npx mcpman install @modelcontextprotocol/server-filesystem
Get Started GitHub
44 Commands
10 AI Clients
1,123 Tests
AES-256 Encryption

Everything you need to manage MCP servers

A complete toolchain for the MCP ecosystem — install, secure, sync, audit, and automate.

🔌

10 AI Clients

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Roo Code, Codex CLI, OpenCode, Continue, and Zed — all from one tool.

📦

Registry & Publish

Resolves from npm, Smithery, GitHub, or the mcpman registry. Publish your own servers with mcpman publish.

🤖

MCP Server Mode

Run mcpman itself as an MCP server with mcpman serve. AI agents can install, audit, and manage servers programmatically.

🌐

Remote Transport

Connect to remote MCP servers over HTTP and SSE. No local process needed — just a URL.

🔐

Encrypted Vault

Store API keys and tokens in an AES-256-CBC encrypted vault. Auto-loaded during install — never in plaintext JSON.

🔄

Skills & Agent Sync

Universal skill spec with format adapters for all 10 clients. Sync agent configs, tools, and rules across editors.

🛡️

Security Audit

Scan for vulnerabilities via OSV API. Trust scoring 0–100. --fix auto-updates vulnerable packages.

📊

Embedded Dashboard

Launch a local dashboard with mcpman dashboard. REST API with server status, audit results, and health checks.

👥

Team Collaboration

Share server configs with your team via mcpman team. RBAC roles, shared vault, and full audit logging.

🏗️

Server Scaffolding

Scaffold new MCP servers with mcpman create. Node.js and Python templates with a working hello tool.

🧩

Plugin System

Extend mcpman with npm-based plugins. Add custom registries like Ollama or HuggingFace with a prefix-based resolver.

↩️

Auto-Rollback

Automatic snapshots before every lockfile write. Restore any of the last 5 states with mcpman rollback.

Quick Start

Up and running in under a minute.

1

Install globally (optional)

Or skip this and use npx for any command.

2

Install a server

mcpman auto-detects your installed AI clients and registers the server with all of them.

3

Run health check

Verifies runtimes, env vars, and server connectivity.

4

Search for more

Find servers on npm or Smithery registry.

shell 
# Install globally
$ npm install -g mcpman

# Or use directly without installing
$ npx mcpman install @modelcontextprotocol/server-filesystem

# Health check all servers
$ mcpman doctor

# Search for servers
$ mcpman search filesystem

# List installed servers
$ mcpman list

# Sync across all clients
$ mcpman sync

44 Commands. One Tool.

A complete CLI for every stage of the MCP server lifecycle.

⚙️ Core
  • install Install & register a server
  • list List installed servers
  • remove Uninstall a server
  • update Update installed servers
  • upgrade Self-upgrade mcpman
🩺 Health
  • doctor Run diagnostics
  • test JSON-RPC validation
  • validate Schema checks
  • status Live process status
  • bench Latency benchmarks
🔧 Config
  • init Scaffold lockfile
  • config Global config CRUD
  • sync Cross-client sync
  • diff Visual client diff
  • env Per-server env vars
  • secrets Encrypted vault
🔍 Discovery
  • search npm + Smithery + mcpman search
  • info Package details
  • why Server provenance
  • publish Publish to registry
🏗️ Authoring
  • create Scaffold new server
  • link Link local server
  • watch Auto-restart on change
🗂️ Organization
  • profiles Named config snapshots
  • group Batch server tags
  • pin Version pinning
  • rollback Restore snapshots
🗃️ Registry
  • registry Custom registry CRUD
  • plugin npm-based plugins
  • completions Shell tab-complete
📦 Migration
  • export Portable JSON bundle
  • import Restore from bundle
  • template Sharable server presets
⚡ Ops
  • run Launch with vault secrets
  • logs Real-time log streaming
  • notify Webhook + shell hooks
  • replay Command history replay
  • alias Command shorthands
  • audit Security vulnerability scan
🤖 Platform
  • serve Run as MCP server
  • dashboard Embedded HTTP dashboard
  • team Team collaboration
  • skill Skills management
  • agent Agent config sync

How mcpman Compares

Built for power users who need more than a basic installer.

Feature mcpman Smithery CLI mcpm.sh
Multi-client support All 10 clients Claude only Limited
Lockfile mcpman.lock None None
Health checks Runtime + env + process None None
Encrypted secrets AES-256 vault None None
Config sync Cross-client + --remove None None
Security audit Trust scoring + auto-fix None None
Registry sources npm + Smithery + GitHub Smithery only npm only
Plugin system npm-based None None
Export / Import Full config portability None None
Server scaffolding Node + Python templates None None
Shell completions bash + zsh + fish None None
Auto-rollback Auto-snapshot + restore None None
CI/CD integration GitHub Actions None None
MCP server mode 8 tools via stdio None None
Remote transport HTTP + SSE None None
Dashboard REST API + UI None None
Team collaboration RBAC + audit log None None

Ready to manage your MCP servers?

No daemon required. Pure CLI. Works anywhere Node ≥ 20 runs.