# 使用 Homebrew 安装 smithery-cli

查看 smithery-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:smithery-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install smithery-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:smithery-cli
- **软件包管理器:** Homebrew
- **版本:** 4.11.1
- **来源摘要:** Install and list Model Context Protocol servers from Smithery
- **主页:** <https://smithery.ai/>
- **最后更新:** 2026-07-08T18:21:24Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- smithery (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.11.1
## 项目历史与用法

Smithery CLI is the command-line interface for Smithery, a platform and registry for connecting AI agents to Model Context Protocol servers, skills, and managed integrations.

### 项目历史

The official source repository, smithery-ai/cli, was created in December 2024 and describes the project as a TypeScript CLI for installing, managing, and developing MCP servers and skills for agents. Its package metadata publishes the npm package as `smithery`, exposes the `smithery` executable, and requires Node.js 20 or newer.

The 2026 changelog shows a major cleanup around the 1.0 and 1.1 line: the npm package was renamed to `smithery`, the CLI moved toward a unified `mcp` noun, auth and deploy UX were simplified, and release automation was consolidated through Release Please and npm publishing workflows.

### 采用历史

Smithery documents the CLI as the primary terminal workflow for searching, connecting, and managing MCP servers and skills. The official docs recommend `npm install -g smithery@latest`, while this input record shows distribution through Homebrew as `smithery-cli`.

As of the official GitHub API response checked for this run, the repository had hundreds of stars and forks, indicating visible adoption in the MCP tooling ecosystem rather than only a private internal tool.

### 使用方式

Typical usage is `smithery mcp search`, `smithery mcp add`, `smithery mcp list`, and `smithery mcp remove` for MCP server connections; `smithery tool list/find/get/call` for connected tools; `smithery skill search/add` for skills; and `smithery auth login/logout/whoami/token` for authentication.

The CLI can write MCP server entries into supported AI client configs, mint service tokens, publish MCP servers or MCPB bundles, and cache Smithery settings in a platform-specific `settings.json` unless `SMITHERY_CONFIG_PATH` overrides the settings directory.

### 为什么软件包爱好者会关心

For package-manager users, Smithery CLI is notable because it sits at the boundary between npm-style global CLIs, Homebrew formula installation, and the newer MCP/agent tooling stack. It is a small command surface that configures other developer tools rather than being only a standalone utility.

The source shows a pragmatic split between file-backed user settings and OS keychain-backed per-server configuration, which matters for package nerds auditing where CLIs persist state, credentials, and generated client configuration.

### 时间线

- 2024-12-22: Official GitHub repository created.
- 2026-05-01: v1.0.0 released.
- 2026-05-22: v1.1.0 release line records breaking CLI/package changes, including the package rename to `smithery` and a unified `mcp` command noun.
- 2026-05-31: v1.2.0 published with support for internal source-backed connections.

### Related projects

- Smithery itself is the hosted platform and registry behind the CLI.
- Model Context Protocol is the integration standard the CLI is built around.
- The Smithery Skills Registry is the official registry surface used by the CLI's skill commands.

### 来源

- <https://api.github.com/repos/smithery-ai/cli>
- <https://api.github.com/repos/smithery-ai/cli/releases>
- <https://github.com/smithery-ai/cli>
- <https://raw.githubusercontent.com/smithery-ai/cli/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/smithery-ai/cli/main/package.json>
- <https://raw.githubusercontent.com/smithery-ai/cli/main/src/lib/keychain.ts>
- <https://raw.githubusercontent.com/smithery-ai/cli/main/src/utils/smithery-settings.ts>
- <https://smithery.ai/docs>
- <https://smithery.ai/docs/concepts/cli>
- source_facts.package-manager.brew


## 安全说明

没有找到 smithery-cli 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: $SMITHERY_CONFIG_PATH/settings.json, $XDG_CONFIG_HOME/smithery/settings.json, ~/.config/smithery/settings.json
- macOS: $SMITHERY_CONFIG_PATH/settings.json, ~/Library/Application Support/smithery/settings.json
- Windows: %SMITHERY_CONFIG_PATH%\settings.json, %APPDATA%\smithery\settings.json

## Credential files

- Linux: $SMITHERY_CONFIG_PATH/settings.json, $XDG_CONFIG_HOME/smithery/settings.json, ~/.config/smithery/settings.json
- macOS: $SMITHERY_CONFIG_PATH/settings.json, ~/Library/Application Support/smithery/settings.json
- Windows: %SMITHERY_CONFIG_PATH%\settings.json, %APPDATA%\smithery\settings.json

## Combined YAML source

View the package source record on GitHub. [combined/smithery-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/smithery-cli.yml)


## 来源

- pkg.so package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph