The Smithery registry installer and manager for Model Context Protocol (MCP) servers, designed to be client-agnostic.

• NodeJS version 18 or above

npx @smithery/cli <command>

• install <package> - Install a package
• --client <name> - Specify the AI client
  • --config <json> - Provide configuration data as JSON (skips prompts)
• uninstall <package> - Uninstall a package
  • --client <name> - Specify the AI client
• inspect <server-id> - Inspect a server interactively
• run <server-id> - Run a server
  • --config <json> - Provide configuration for the server
• list clients - List available clients
• --help - Show help message
• --verbose - Show detailed logs for debugging

# Install a server (requires --client flag) npx @smithery/cli install mcp-obsidian --client claude # Install a server with pre-configured data (skips prompts) npx @smithery/cli install mcp-obsidian --client claude --config '{"vaultPath":"path/to/vault"}' # Remove a server npx @smithery/cli uninstall mcp-obsidian --client claude # List available clients npx @smithery/cli list clients # Inspect a specific server from smithery's registry npx @smithery/cli inspect mcp-obsidian # Run a server with configuration npx @smithery/cli run mcp-obsidian --config '"{\\"key\\":\\"value\\"}"' # Show help menu npx @smithery/cli --help # Install with verbose logging for debugging npx @smithery/cli install mcp-obsidian --client claude --verbose

• Remember to restart your AI client after installing or uninstalling servers
• Use the inspect command for interactive server testing
• Run without arguments to see the help menu
• Use --verbose flag for detailed logs when troubleshooting

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

1. Clone the repository:

   git clone https://github.com/smithery-ai/cli cd cli

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

# List all servers npx . <command> # Inspect a specific server npx . inspect <server-id> # Install a server npx . install <server-name> --client <client-name> # Run with verbose logging npx . <command> --verbose

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