smithery-ai-cli

Smithery CLI 是一个强大的命令行界面，专为开发者与智能体架构师设计，用于探索、连接与管理模型上下文协议 (MCP) 服务器及可重用的智能体技能。它作为通往拥有超过 10 万种工具的广阔市场的入口，让您能将 GitHub、Slack、Discord、Jira、Notion 及各类云端 API 等专业服务直接整合至您的 AI 工作流中。通过提供统一的工具安装与连接管理界面，Smithery 简化了复杂智能体环境的设置过程。

• 使用直观的命令行指令，在庞大的 Smithery 注册表中搜索特定的 MCP 服务器、工具或集成技能。

• 管理连接生命周期，包括 OAuth 验证、凭据存储以及长期 MCP 会话的维护。

• 将资源组织到隔离的命名空间中，以便为不同的开发、测试或生产环境维护独立的配置。

• 直接从终端检查工具功能、查看输入与输出的 JSON 架构，并执行工具调用以测试功能。

• 支持串接 JSONL 输出，实现与其它 Unix 风格命令行工具的无缝集成，方便数据处理与自动化。

• 通过令牌范围 (Token Scoping) 提供细粒度的安全性控制，允许您定义特定策略以限制资源访问、操作与请求层级的方法执行 (rpcReqMatch)。

• 使用者应通过 smithery auth login 进行验证，以启用对受保护服务与云端托管 MCP 服务器的访问。

• 使用 smithery mcp add 配合服务 URL 或注册名称来初始化新连接，并使用 smithery tool list 来探索可用方法。

• 在构建基于智能体的自动化流程时，请利用令牌策略引擎来限制权限，确保 AI 智能体在最小权限原则下运行。

• 本工具支持 Node.js 20+，并需要互联网连接以进行注册表搜索与远程 MCP 服务器通信。

• 连接状态监控至关重要；若连接进入 auth_required 状态，CLI 会提供 URL 让人工介入授权以恢复会话连接。