smithery-ai-cli

Smithery CLI 是一個強大的命令行介面，專為開發者與 AI 代理架構師設計，用於探索、連接與管理模型上下文協議 (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 讓人工介入授權以恢復工作階段連線。