smithery/cli

A lightweight registry and package manager for Model Context Protocol (MCP) servers, designed to be client-agnostic.

Installation

npm install -g @smithery/cli

Usage

npx @smithery/cli <command>

Available Commands

• list - Browse and search available packages
• install <pkg> - Install a package
  • --client <name> - Specify AI client (e.g. claude)
• uninstall <pkg> - Remove an installed package
• installed - View installed packages
• get <pkg> - Show package details
• inspect - Inspect available servers and primitives

Examples

# Browse available packages
npx @smithery/cli list

# Install a package (defaults to --client claude)
npx @smithery/cli install mcp-obsidian

# Install for specific client
npx @smithery/cli install mcp-obsidian --client claude

# View installed packages
npx @smithery/cli installed

# Remove a package
npx @smithery/cli uninstall mcp-obsidian

# Get package details
npx @smithery/cli get mcp-obsidian

# Inspect servers
npx @smithery/cli inspect

Important Notes

• When installing unverified packages, you'll be prompted to:
  1. Confirm installation
  2. Select runtime (Node.js/Python)
• Remember to restart Claude after uninstalling packages
• Use the inspect command for interactive server testing
• Run without arguments to see the help menu

Development

This guide will help you get started with developing for @smithery/cli.

Getting Started

1. Clone the repository:

   git clone [email protected]:smithery-ai/cli.git
   cd cli

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Development Commands

# List all packages
npx . list

# Get details about a specific package
npx . get <package-id>

# Install a package
npx . install <package-name>

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.