Smithery CLI

Smithery CLI

site icon
2025.04.17 224
TypeScriptMCP 服务器管理命令行工具开发效率
Smithery CLI 是一个用于 Model Context Protocol (MCP) 服务器的注册表安装和管理工具,设计为客户端无关。它提供了安装、卸载、检查和运行 MCP 服务器的功能,支持多种 AI 客户端。
View on GitHub

Overview

基本能力

产品定位

Smithery CLI 是一个用于管理 MCP 服务器的命令行工具,旨在简化 MCP 服务器的安装、配置和运行过程。

核心功能

  • 安装 MCP 服务器包
  • 卸载 MCP 服务器包
  • 检查服务器交互式
  • 运行服务器
  • 列出可用客户端和已安装的服务器

适用场景

  • 开发人员需要快速安装和配置 MCP 服务器
  • 需要管理多个 MCP 服务器的环境
  • 调试和测试 MCP 服务器

工具列表

  • install <package>: 安装一个 MCP 服务器包
  • uninstall <package>: 卸载一个 MCP 服务器包
  • inspect <server-id>: 交互式检查一个服务器
  • run <server-id>: 运行一个服务器
  • list clients: 列出可用客户端
  • list servers --client <name>: 列出特定客户端的已安装服务器

常见问题解答

  • 安装或卸载服务器后需要重启 AI 客户端
  • 使用 --verbose 标志进行详细日志记录以进行故障排除

使用教程

使用依赖

  • NodeJS 版本 18 或更高

安装教程

  1. 使用 npm 安装 Smithery CLI
npx @smithery/cli install mcp-obsidian --client claude
  1. 使用预配置数据安装服务器(跳过提示)
npx @smithery/cli install mcp-obsidian --client claude --config '{"vaultPath":"path/to/vault"}'

调试方式

  1. 使用 --verbose 标志进行详细日志记录
npx @smithery/cli install mcp-obsidian --client claude --verbose
  1. 检查特定服务器
npx @smithery/cli inspect mcp-obsidian

许可证

该项目遵循 AGPL-3.0 开源许可条款,请参阅 AGPL-3.0 了解完整条款。