@smithery/cli 3.18.0 → 4.0.0-preview.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +34 -55
  2. package/dist/index.js +359 -362
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -11,18 +11,22 @@ Requires Node.js 20+.
11
11
 
12
12
  ## Commands
13
13
 
14
- ### Servers
14
+ ### MCP Servers
15
15
 
16
16
  ```bash
17
- smithery install <server> # Install a server to an AI client
18
- smithery uninstall <server> # Remove a server
19
- smithery list # List installed servers
20
- smithery search [term] # Search the Smithery registry
21
- smithery inspect <server> # Interactive server testing
22
- smithery run <server> # Run an MCP bundle locally
17
+ smithery mcp search [term] # Search the Smithery registry
18
+ smithery mcp add <url> # Add an MCP server connection
19
+ smithery mcp list # List your connections
20
+ smithery mcp remove <ids...> # Remove connections
23
21
  ```
24
22
 
25
- Options: `--client <name>` to skip client selection, `--config <json>` to provide configuration.
23
+ ### Tools
24
+
25
+ ```bash
26
+ smithery tools list [connection] # List available tools
27
+ smithery tools search <query> # Search tools by intent
28
+ smithery tools call <connection> <tool> [args] # Call a tool
29
+ ```
26
30
 
27
31
  ### Skills
28
32
 
@@ -42,74 +46,49 @@ smithery skills review upvote <skill> <review-id> # Upvote a review
42
46
  smithery skills review downvote <skill> <review-id> # Downvote a review
43
47
  ```
44
48
 
45
- ### Namespaces
46
-
47
- Discover public namespaces on Smithery.
49
+ ### Auth
48
50
 
49
51
  ```bash
50
- smithery namespace search [query] # Search public namespaces (requires login)
52
+ smithery auth login # Login with Smithery (OAuth)
53
+ smithery auth logout # Log out
54
+ smithery auth whoami # Check current user
51
55
  ```
52
56
 
53
- Options: `--limit <n>`, `--has-skills`, `--has-servers`.
54
-
55
- ### Smithery Connect (Cloud MCP)
56
-
57
- Manage cloud-hosted MCP servers via [Smithery Connect](https://smithery.ai).
57
+ ### Namespaces
58
58
 
59
59
  ```bash
60
- # Namespace context (auto-created on first use)
61
- smithery namespace list # List your namespaces
62
- smithery namespace use <name> # Set current namespace
63
- smithery namespace show # Show current namespace
64
-
65
- # Server connections
66
- smithery connect add <url> # Add MCP server (--name for display name)
67
- smithery connect list # List connected servers
68
- smithery connect remove <id> # Remove a connection
69
-
70
- # Tools
71
- smithery connect tools [server] # List tools (all or for specific server)
72
- smithery connect search <query> # Fuzzy search tools by intent
73
- smithery connect call <id> [args] # Call a tool (format: server/tool-name)
60
+ smithery namespace list # List your namespaces
61
+ smithery namespace use <name> # Set current namespace
62
+ smithery namespace search [query] # Search public namespaces
74
63
  ```
75
64
 
76
65
  ### Development
77
66
 
78
67
  ```bash
79
- smithery login # Login with Smithery (OAuth)
80
- smithery dev [entry] # Dev server with hot-reload and tunnel
81
- smithery build [entry] # Build for production
82
- smithery playground # Open interactive testing UI
68
+ smithery mcp dev [entry] # Dev server with hot-reload and tunnel
69
+ smithery mcp build [entry] # Build for production
70
+ smithery mcp publish [entry] # Publish to Smithery
71
+ smithery mcp playground # Open interactive testing UI
83
72
  ```
84
73
 
85
74
  ## Examples
86
75
 
87
76
  ```bash
88
- # Install a server locally
89
- smithery install exa --client cursor
77
+ # Search and connect to an MCP server
78
+ smithery mcp search "github"
79
+ smithery mcp add https://server.smithery.ai/github --id github
80
+
81
+ # Discover and use tools
82
+ smithery tools search "create issue"
83
+ smithery tools call github create_issue '{"title":"Bug fix","body":"..."}'
90
84
 
91
85
  # Browse and install skills
92
- smithery skills search "frontend" --json --page 2 # Paginated results
93
- smithery skills search --namespace anthropics --json # Filter by namespace
86
+ smithery skills search "frontend" --json --page 2
94
87
  smithery skills install anthropics/frontend-design --agent claude-code
95
88
 
96
- # Review and vote on skills
97
- smithery skills review list anthropics/frontend-design
98
- smithery skills review add anthropics/frontend-design --up -b "Great for Tailwind components, follows accessibility best practices"
99
- smithery skills review upvote anthropics/frontend-design 550e8400-e29b-41d4-a716-446655440000
100
- smithery skills upvote anthropics/frontend-design
101
-
102
- # Discover namespaces
103
- smithery namespace search --has-skills # Find namespaces with skills
104
-
105
- # Cloud MCP workflow (works with any MCP server URL)
106
- smithery connect add https://server.smithery.ai/github # Or any MCP server
107
- smithery connect search "create issue"
108
- smithery connect call github/create_issue '{"title":"Bug fix","body":"..."}'
109
-
110
89
  # Development
111
- smithery dev server.ts --port 3000
112
- smithery build --out dist/server.cjs
90
+ smithery mcp dev server.ts --port 3000
91
+ smithery mcp build --out dist
113
92
  ```
114
93
 
115
94
  ## Development