# 使用 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 - **主页:** - **上游文档:** - **许可证:** AGPL-3.0-or-later - **源码归档:** - **最后更新:** 2026-07-08T18:21:24Z - **已生成:** 2026-08-04T22:13:35+00:00 ## 可执行文件 - smithery (cli) - smithery (别名) ## 依赖 - node ## 安装行为 - post-install 钩子: 未定义 - Bottle: 可用 于 all ## 版本和新鲜度 - 页面生成时间: 2026-08-04 - 管理器版本: 4.11.1 - 管理器更新时间: 2026-07-08 - 本地数据: OK - 上游仓库: https://smithery.ai/ - 信息: Release/tag comparison is only available for GitHub repositories. ## 项目历史与用法 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. ### 来源 - - - - - - - - - - source_facts.package-manager.brew ## 安全说明 没有找到 smithery-cli 的匹配本地密钥处理 manifest。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 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 ## 源数据库详情 - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** smithery-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## 相关链接 - [MCP tool packages](https://pkg.so/zh-hans/mcp-tools/) - Mentions MCP or Model Context Protocol. - [AI and agent packages](https://pkg.so/zh-hans/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata. - [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://pkg.so/zh-hans/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [node](https://pkg.so/zh-hans/brew/node/) - Runtime dependency declared by Homebrew. - [notion-mcp-server](https://pkg.so/zh-hans/brew/notion-mcp-server/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, mcp. - [mcp-remote](https://pkg.so/zh-hans/brew/mcp-remote/) - Shares pkgdb curated category or tags: ai, cli, mcp, oauth. - [github-mcp-server](https://pkg.so/zh-hans/brew/github-mcp-server/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [mcp-toolbox](https://pkg.so/zh-hans/brew/mcp-toolbox/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [n8n-mcp](https://pkg.so/zh-hans/brew/n8n-mcp/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [playwright-mcp](https://pkg.so/zh-hans/brew/playwright-mcp/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [chrome-devtools-mcp](https://pkg.so/zh-hans/brew/chrome-devtools-mcp/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [mcp-grafana](https://pkg.so/zh-hans/brew/mcp-grafana/) - Shares pkgdb curated category or tags: ai, cli, mcp. - [add-mcp](https://pkg.so/zh-hans/npm/add-mcp/) - Local package facts share a topical domain. Shared terms: agents, ai, ai-agents, cli, context. ## 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 - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - cross-ecosystem install command graph