Smithery AI CLI：AI智能体市场命令行工具，连接10万+工具与技能
The Agent Skills Directory
1,900 周安装量
安装命令
npx skills add https://smithery.ai/skills/smithery-ai/cli🇨🇳中文介绍
Smithery
AI 智能体市场。即时连接超过 10 万种工具和技能。
使用 smithery --help 和 <command> --help 查看标志、参数和完整示例。本技能侧重于核心概念和标准工作流。
快速开始
# 1. 安装
npm install -g @smithery/cli
# 2. 身份验证（需要在浏览器中人工确认）
smithery auth login
# 3. 搜索 MCP 服务器
smithery mcp search "github"
# 4. 连接到服务器（URL 或限定名称均可）
smithery mcp add "https://github.run.tools" --id github
# 5. 浏览工具（树状视图 — 通过传递前缀可深入查看分组）
smithery tool list github
smithery tool list github issues.
# 6. 检查工具的输入/输出 JSON 模式
smithery tool get github issues.create
# 7. 调用工具
smithery tool call github issues.create '{"repo": "owner/repo", "title": "Bug"}'
核心概念
命名空间
命名空间是 Smithery 资源的工作空间边界。服务器、连接和技能都存在于一个命名空间中。为每个应用/环境使用一个命名空间（例如 my-app-dev、my-app-prod），然后将其设置为您的活动上下文。标准流程：
smithery namespace list
smithery namespace create my-app-prod
smithery namespace use my-app-prod
有关命名空间特定的标志和覆盖项，请运行 smithery namespace --help 和 smithery mcp --help。
连接 (MCP 连接)
连接是一个受管理的、长期存在的 MCP 会话。Smithery Connect 处理 OAuth 流程、凭证存储、令牌刷新和会话生命周期。连接状态模型：
connected：准备就绪，可以列出/调用工具auth_required：需要人工打开授权 URLerror：检查详细信息并重试/修复配置
标准流程（单用户作用域连接）：
smithery mcp add https://github.run.tools \
--id user-123-github \
--metadata '{"userId":"user-123"}'
smithery mcp list --metadata '{"userId":"user-123"}'
smithery tool list user-123-github
如果 CLI 显示 auth_required，请告知您的人工用户打开 URL，然后重试。
令牌作用域
服务令牌是用于浏览器/移动端/智能体使用的受限凭证。切勿将完整的 API 密钥传递给不受信任的代码。策略心智模型：
- 令牌策略是一个或多个约束条件
- 在 CLI 中，每个
--policy标志传递一个 JSON 对象 - 一个约束条件内的字段是“与”关系（字段越多，范围越窄）
- 列表和多个约束条件是“或”关系（条目越多，范围越宽）
标准用户作用域令牌：
smithery auth token --policy '{
"namespaces": "my-app",
"resources": "connections",
"operations": ["read", "execute"],
"metadata": { "userId": "user-123" },
"ttl": "1h"
}'
请求级工具限制 (rpcReqMatch，实验性功能)
使用 rpcReqMatch 来限制特定的 MCP JSON-RPC 请求（通过请求路径的正则表达式）。重要提示：连接 ID 不在 JSON-RPC 主体中，因此需要组合使用：
metadata用于连接级别的限制rpcReqMatch用于方法/工具限制
标准组合限制：
smithery auth token --policy '{
"resources": "connections",
"operations": "execute",
"metadata": { "connectionId": "my-github" },
"rpcReqMatch": {
"method": "tools/call",
"params.name": "^issues\\."
},
"ttl": "30m"
}'
管道输出
当输出被管道传输时，Smithery 命令会发出 JSONL（每行一个 JSON 对象）：
smithery tool list github --flat --limit 1000 | grep label
每周安装量
1.9K
来源
首次出现
2026年2月28日
安全审计
安装于
codex1.6K
cursor1.6K
opencode1.6K
gemini-cli1.6K
github-copilot1.6K
cline1.6K
🇺🇸English
Smithery
The marketplace for AI agents. Connect to 100K+ tools and skills instantly.
Use smithery --help and <command> --help for flags, arguments, and full examples. This skill focuses on concepts and canonical workflows.
Quick Start
# 1. Install
npm install -g @smithery/cli
# 2. Authenticate (requires human to confirm in browser)
smithery auth login
# 3. Search for MCP servers
smithery mcp search "github"
# 4. Connect to a server (URL or qualified name both work)
smithery mcp add "https://github.run.tools" --id github
# 5. Browse tools (tree view — drill into groups by passing the prefix)
smithery tool list github
smithery tool list github issues.
# 6. Inspect tool input/output JSON schema
smithery tool get github issues.create
# 7. Call a tool
smithery tool call github issues.create '{"repo": "owner/repo", "title": "Bug"}'
Core Concepts
Namespaces
A namespace is the workspace boundary for Smithery resources. Servers, connections, and skills all live in a namespace. Use one namespace per app/environment (for example, my-app-dev, ), then set it as your active context. Canonical flow:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
