Smithery CLI

Smithery CLI 可以让你的代理直接通过命令行连接到数千种技能和 MCP 服务器。要开始使用，只需运行 npx skills add smithery/cli。

安装

npm install -g @smithery/cli@latest

需要 Node.js 20 或更高版本。

命令

MCP 服务器

smithery mcp search [term]              # 搜索 Smithery 注册表
smithery mcp add <url>                  # 添加一个 MCP 服务器连接
smithery mcp list                       # 列出你的连接
smithery mcp remove <ids...>            # 移除连接

工具

与通过 smithery mcp 连接的 MCP 服务器上的工具进行交互。

smithery tool list [connection]        # 列出你已连接的 MCP 服务器上的工具
smithery tool find [query]             # 按名称或意图搜索工具
smithery tool get <connection> <tool>  # 显示某个工具的完整详情
smithery tool call <connection> <tool> [args]  # 调用工具

技能

浏览并安装来自 Smithery 技能注册表 的技能。

smithery skill search [query]                        # 搜索技能
smithery skill add <skill> --agent <name>             # 添加技能
smithery skill upvote <skill>                        # 为技能点赞
smithery skill downvote <skill>                      # 为技能踩踏

# 评论
smithery skill review list <skill>                   # 列出评论
smithery skill review add <skill> --up -b "text"     # 添加评论并投票
smithery skill review remove <skill>                 # 删除你的评论
smithery skill review upvote <skill> <review-id>     # 为评论点赞
smithery skill review downvote <skill> <review-id>   # 为评论踩踏

认证

smithery auth login                     # 使用 Smithery 登录（OAuth）
smithery auth logout                    # 注销
smithery auth whoami                    # 查看当前用户
smithery auth token                     # 生成服务令牌
smithery auth token --policy '<json>'   # 生成受限令牌

命名空间

smithery namespace list                 # 列出你的命名空间
smithery namespace use <name>           # 设置当前命名空间

发布

smithery mcp publish <url> -n <org/server>  # 发布 MCP 服务器 URL

示例

# 搜索并连接到一个 MCP 服务器
smithery mcp search "github"
smithery mcp add https://server.smithery.ai/github --id github

# 查找并调用你已连接的 MCP 服务器上的工具
smithery tool find "create issue"
smithery tool call github create_issue '{"title":"Bug fix","body":"..."}'

# 浏览并安装技能
smithery skill search "frontend" --json --page 2
smithery skill add anthropics/frontend-design --agent claude-code

# 发布你的 MCP 服务器 URL
smithery mcp publish "https://my-mcp-server.com" -n myorg/my-server

开发

git clone https://github.com/smithery-ai/cli
cd cli && pnpm install && pnpm run build
npx . --help

贡献

欢迎贡献！请提交 Pull Request。

Smithery CLI 快速上手指南

Smithery CLI 是一款命令行工具，可帮助开发者将 AI Agent 直接连接到数千种技能（Skills）和 MCP 服务器，实现能力的快速扩展。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本需为 20+。
  • 检查版本命令：node -v
  • 如未安装或版本过低，请访问 Node.js 官网 下载最新版。
• 包管理器: 推荐使用 npm (随 Node.js 自带) 或 pnpm。
  • 国内加速建议：如遇网络连接缓慢，可临时切换至淘宝镜像源：

  npm config set registry https://registry.npmmirror.com
  

安装步骤

您可以通过 npm 全局安装 Smithery CLI：

npm install -g @smithery/cli@latest

安装完成后，可通过以下命令验证安装是否成功：

smithery --help

提示：如果您不想全局安装，也可以直接使用 npx 运行（首次运行会自动下载）： npx @smithery/cli --help

基本使用

以下是使用 Smithery CLI 的核心流程，涵盖登录、连接 MCP 服务器及调用工具。

1. 登录认证

在使用需要权限的功能（如发布服务、管理技能）前，建议先登录：

smithery auth login

系统将引导您通过 OAuth 完成浏览器登录。

2. 搜索并连接 MCP 服务器

MCP (Model Context Protocol) 服务器提供了各种工具能力。以下示例演示如何搜索并连接 GitHub 相关的 MCP 服务：

# 搜索 MCP 服务器
smithery mcp search "github"

# 添加连接（指定 URL 和本地 ID）
smithery mcp add https://server.smithery.ai/github --id github

3. 查找并调用工具

连接成功后，您可以查找该服务器提供的具体工具并直接调用：

# 查找名为 "create issue" 的工具
smithery tool find "create issue"

# 调用工具（传入 JSON 格式参数）
smithery tool call github create_issue '{"title":"Bug fix","body":"Fixing a critical bug"}'

4. 浏览与安装技能 (Skills)

您还可以从 Smithery 技能注册中心浏览并安装预设的技能组合：

# 搜索前端相关技能
smithery skill search "frontend"

# 将技能安装到指定的 Agent（例如 claude-code）
smithery skill add anthropics/frontend-design --agent claude-code

---

更多高级命令（如发布 MCP 服务、管理命名空间等）请运行 smithery --help 查看完整文档。