cli

# Smithery CLI [](https://www.npmjs.com/package/@smithery/cli) [](https://www.npmjs.com/package/@smithery/cli) The Smithery registry installer and manager for Model Context Protocol (MCP) servers, designed to be client-agnostic. ## Requirements - NodeJS version 20 or above ## Installation Install globally for easier usage: ```bash npm install -g @smithery/cli ``` ## Usage ```bash smithery <command> ``` Or run directly without installation: ```bash npx @smithery/cli <command> ``` ### Available Commands - `install <server>` - Install a server (interactive client selection) - `--client <name>` - Specify the AI client (skips selection) - `--config <json>` - Provide configuration data as JSON (skips prompts) - `uninstall <server>` - Uninstall a server (interactive client selection) - `--client <name>` - Specify the AI client (skips selection) - `inspect <server-id>` - Inspect a server interactively - `run <server-id>` - Run a server - `--config <json>` - Provide configuration for the server - `list` - List installed servers (interactive client selection) - `--client <name>` - Specify the AI client (skips selection) - `search [term]` - Search for servers in the Smithery registry (interactive) - `login` - Login with an API key (interactive) - `dev [entryFile]` - Start development server with hot-reload and tunnel - `--port <port>` - Port to run the server on (default: 8081) - `--key <apikey>` - Provide an API key - `--no-open` - Don't automatically open the playground - `--prompt <prompt>` - Initial message to start the playground with - `-c, --config <path>` - Path to config file (default: auto-detect smithery.config.js) - `build [entryFile]` - Build MCP server for production - `-o, --out <outfile>` - Output file path (default: .smithery/index.cjs) - `--transport <type>` - Transport type: shttp or stdio (default: shttp) - `-c, --config <path>` - Path to config file (default: auto-detect smithery.config.js) - `playground` - Open MCP playground in browser - `--port <port>` - Port to expose (default: 8081) - `--key <apikey>` - Provide an API key - Can pass command after `--` separator - `--help` - Show help message - `--verbose` - Show detailed logs for debugging ### Examples ```bash # Install a server (interactive client selection) smithery install exa # Install a server for specific client (skips selection) smithery install exa --client claude # Install a server with pre-configured data (skips prompts) smithery install exa --client claude --config '{"exaApiKey":"you_api_key"}' # Remove a server (interactive client selection) smithery uninstall exa # Remove a server from specific client (skips selection) smithery uninstall exa --client claude # List installed servers (interactive) smithery list # List installed servers for claude smithery list --client claude # Search for servers in the registry smithery search "web search" # Search interactively (prompts for term) smithery search # Inspect a specific server from smithery's registry smithery inspect exa # Run a server with configuration smithery run exa --config '{"key":"value"}' # Login and set API key smithery login # Start development server with hot-reload smithery dev smithery dev server.ts --port 3000 # Build server for production smithery build smithery build server.ts --out dist/server.cjs --transport stdio # Open playground in browser smithery playground smithery playground --port 3001 -- node dist/server.js # Show help menu smithery --help # Install with verbose logging for debugging smithery install mcp-obsidian --client claude --verbose ``` ### Important Notes - Use `login` command to set your Smithery API key (required for some operations) - 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 - The `dev` command provides hot-reload for MCP server development - Use `playground` to test your MCP servers in an interactive web interface ## Development This guide will help you get started with developing for @smithery/cli. ### Getting Started 1. Clone the repository: ```bash git clone https://github.com/smithery-ai/cli cd cli ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` ### Development Commands ```bash # List installed servers npx . list --client claude # Search for servers npx . search obsidian # 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 ``` ## Contributing Contributions are welcome! Please feel free to submit a Pull Request.