Smithery CLI

Smithery CLI 是一个用于管理 Model Context Protocol (MCP) 服务器的命令行工具，支持多种 AI 客户端，如 Claude。它提供安装、卸载、查看和运行服务器的功能，帮助用户轻松集成和管理本地服务。通过简单的 npx 命令即可完成服务器的安装与配置。

核心功能

Smithery CLI 提供了多种核心功能，使用户能够高效管理 MCP 服务器：

• 服务器安装：支持为不同的 AI 客户端安装各种 MCP 服务器，例如将 Obsidian 与 Claude 集成。
• 服务器管理：允许用户查看和卸载已安装的服务器，便于维护和更新。
• 服务器检查：提供交互式检查功能，帮助用户深入了解服务器的配置和状态。
• 服务器运行：支持直接运行已安装的服务器，方便测试和调试。

安装方法

Smithery CLI 无需额外安装步骤，直接通过 npx 命令调用即可使用。但需要确保系统中已安装 Node.js 18 或更高版本。

node --version

如果 Node.js 版本不符合要求，请先升级 Node.js。

使用方法

Smithery CLI 提供了丰富的命令，支持安装、卸载、运行和检查服务器。以下是一些常用命令及其示例：

npx @smithery/cli install mcp-obsidian --client claude

npx @smithery/cli list servers --client claude

npx @smithery/cli run mcp-obsidian

npx @smithery/cli inspect mcp-obsidian

用户还可以通过 --config 参数提供 JSON 格式的配置数据，跳过交互式提示。

npx @smithery/cli install mcp-obsidian --client claude --config '{"vaultPath":"path/to/vault"}'

此外，--verbose 参数可用于显示详细日志，便于调试。

npx @smithery/cli install mcp-obsidian --client claude --verbose

使用场景

Smithery CLI 适用于需要为 AI 客户端扩展功能或集成特定服务的场景。例如：

• 将本地 Obsidian 笔记库与 Claude AI 集成，实现知识共享。
• 为不同 AI 客户端安装和管理多个 MCP 服务器，提升工作效率。
• 通过交互式检查和运行服务器，快速调试和验证配置。

注意事项

在使用 Smithery CLI 时，需要注意以下事项：

• 安装或卸载服务器后，需要重启 AI 客户端以使更改生效。
• 使用 --client 参数指定客户端，确保安装正确的服务器版本。
• 如果遇到问题，可以使用 --verbose 参数查看详细日志。

常见命令

Smithery CLI 提供了多种常用命令，以下是部分命令及其说明：

• list clients：列出所有支持的 AI 客户端。
• list servers --client ：列出指定客户端已安装的服务器。
• inspect ：交互式检查服务器详细信息。
• run ：运行已安装的服务器。
• --help：显示帮助信息。
• --verbose：显示详细日志。

Smithery CLI 通过简洁的命令行界面，为用户提供了一种高效管理 MCP 服务器的方式，适用于需要集成本地服务与 AI 客户端的场景。