Smithery

技能简介

Smithery 是一个面向 AI Agent 的工具与能力分发平台，目标是「让智能体拥有更多自主能力」——把 AI 代理连接到外部世界的成千上万种工具与服务中。它基于开放的 Model Context Protocol（MCP）标准构建，让开发者可以在几分钟内把搜索、数据库、浏览器控制、商业软件等能力接入自己的 Agent，同时也可以把自己开发的能力发布出来供他人使用。无论是聊天机器人、后台智能体还是 AI 副驾驶，Smithery 都替你处理好「把代理插进外部服务」过程中最繁琐的部分。

核心能力

1. 海量工具目录 — 提供不断增长的 MCP 工具与集成目录，覆盖联网搜索、深度研究、数据库查询、浏览器控制等常见能力，即插即用。
2. 零 OAuth 配置 — 无需再手动管理重定向 URI、客户端 ID 或密钥，平台自动完成 OAuth 授权流程。
3. 令牌自动刷新 — 凭证会在后台自动续期，无需人工干预即可长期保持有效。
4. 安全凭证存储 — 采用加密的只写存储保护 API Key 与令牌，降低泄露风险。
5. 无状态连接管理 — 连接的生命周期由平台自动管理，你只负责调用工具，不必操心底层连接状态。
6. 一次连接、处处复用 — 工具只需连接一次，即可在对话、工作流和不同运行时（Claude、GPT、开源模型、CLI 工具）之间重复使用。
7. 发布与可观测性 — 开发者可把自己开发的集成发布到 Smithery，触达 AI 智能体生态，并查看工具的实际调用情况与使用数据。

安装配置

1. 安装 CLI — 通过 npm 包直接运行，命令为 npx smithery，无需全局安装即可开始使用。
2. 登录授权 — 执行 npx smithery auth login 完成账号登录。
3. 添加 MCP 工具 — 执行 npx smithery mcp add notion，若提示 auth_required，按返回的授权链接在浏览器中完成授权。

使用步骤

1. 登录：运行 npx smithery auth login，完成账号认证。
2. 添加工具：用 npx smithery mcp add 连接你需要的服务（如 notion）。
3. 完成授权：根据终端返回的 https://auth.smithery.ai/... 链接访问并授权，OAuth 流程由平台自动处理。
4. 查看可用工具：执行 npx smithery tool list 列出该服务下当前可调用的所有工具。
5. 调用工具：执行 npx smithery tool call ''，例如调用 notion 创建页面。

适用场景

1. 联网搜索与深度研究 — 接入 Exa 等搜索服务，让 Agent 检索实时网页、访问 LinkedIn 资料、执行深度调研。
2. 实时文档引用 — 接入 Context7，在 Cursor 或 Claude Code 中直接引用各大 SDK 与框架的最新文档。
3. 远程浏览器控制 — 接入 Browserbase，借助 Stagehand 让 Agent 操控远端浏览器完成复杂网页任务。
4. 商业软件集成 — 把 Notion、数据库、企业工具等接入 Agent，实现资料查询与自动化操作。
5. 能力发布与分发 — 开发者把自己写的 MCP 服务发布到 Smithery，获得分发渠道与调用观测。

适用人群

• 正在构建聊天机器人、后台智能体或 AI 副驾驶的开发者
• 需要为 Agent 快速接入外部工具与数据源的 AI 工程团队
• 希望把自研 MCP 服务分发给更多用户的工具开发者
• 关注 Agent 生态与 MCP 标准落地的产品与技术团队

工作原理

Smithery 底层使用 Model Context Protocol（MCP）标准——一套让 AI 代理与外部工具、数据源之间用统一格式通信的开放协议。平台在此之上封装了连接与认证层：当某个请求需要鉴权时，Smithery 会自动完成 OAuth 流程、注入凭证并在必要时重试；连接凭证由开源的 agent.pw「智能体保险库」提供支撑。对于开发者而言，底层连接是无状态的，生命周期完全由平台托管，因此同一套已连接账号可以跨不同模型与运行时被复用。

官方链接

https://smithery.ai

官方文档：https://smithery.ai/docs