One-click MCP server installation across AI clients

MCP Installer is a command-line tool that simplifies the installation and management of MCP (Model Context Protocol) servers across different AI clients like Claude Code, Claude Desktop, Cursor, Gemini and more to come(Windsurf, VS Code, Cline, etc.).

npm install -g @mcp-installer/cli

# Install a server to all detected clients
mcp-installer install playwright

# Install to specific clients
mcp-installer install filesystem --clients=cursor,gemini

# List available servers
mcp-installer list --available

• Playwright - Browser automation and testing capabilities
• GitHub - Interact with GitHub repositories, issues, and pull requests (requires auth)

• Filesystem - Secure local file system access with configurable permissions
• SQLite - Query and manage SQLite databases with full CRUD operations

Use mcp-installer list --available to see the complete list with details in a beautiful table format.

mcp-installer install <server-name> [options]

Options:

• --clients <clients> - Comma-separated list of clients (default: "all")
• --dry-run - Show what would be installed without making changes
• --no-backup - Skip creating backup before installation
• --force - Force installation even if server already exists

Examples:

# Install Playwright to all clients
mcp-installer install playwright

# Install to specific clients only
mcp-installer install github --clients=cursor,gemini

# Dry run to see what would happen
mcp-installer install sqlite --dry-run

mcp-installer uninstall <server-name> [options]

Options:

• --clients <clients> - Comma-separated list of clients (default: "all")
• --dry-run - Show what would be uninstalled without making changes
• --no-backup - Skip creating backup before uninstallation

mcp-installer list [options]

Options:

• --available - List available servers from registry
• --installed - List installed servers
• --client <client> - Show servers for specific client

Examples:

# List all available servers
mcp-installer list --available

# List installed servers for all clients
mcp-installer list --installed

# List servers for specific client
mcp-installer list --installed --client=cursor

mcp-installer update [options]

Options:

• --clear-cache - Clear the registry cache before updating
• --show-cache - Show information about the registry cache

Examples:

# Update server registry from remote source
mcp-installer update

# Clear cache and force fresh download
mcp-installer update --clear-cache

# Show cache information
mcp-installer update --show-cache

The update command fetches the latest server registry from the remote source, ensuring you have access to the newest MCP servers without updating the CLI tool itself.

mcp-installer doctor [options]

Options:

• --client <client> - Check specific client only

# Create backup
mcp-installer backup [options]

# Restore from backup
mcp-installer restore <backup-path> [options]

Backup Options:

• --clients <clients> - Comma-separated list of clients to backup (default: "all")
• --output <path> - Output directory for backups

Restore Options:

• --client <client> - Restore specific client only
• --force - Force restoration without confirmation

• Node.js >= 18.0.0
• At least one supported AI client installed

"No supported AI clients detected"

• Ensure you have Claude Desktop, Cursor, or Gemini installed
• Run mcp-installer doctor for detailed diagnostics

# System diagnostics
mcp-installer doctor

# Validate configurations
mcp-installer doctor --client=cursor

For local development and testing:

# Install pnpm globally if needed
npm install -g pnpm

# Clone and setup
git clone <repository-url>
cd mcp-installer
pnpm install
pnpm run build

For detailed development workflows, see DEVELOPMENT.md.

Made with curiosity and ❤️ to simplify MCP adoption for everyone