Serverman (Server Manager) 使用说明

项目简介

Serverman (Server Manager) 是一个用于管理 MCP (Model Context Protocol) 服务器配置的工具。它提供命令行界面，支持版本控制、配置预设、多客户端管理等功能。此外，Serverman 还包含一个伴侣 MCP 服务器，该服务器可以被 LLM (大型语言模型) 调用，从而实现通过 LLM 自动化管理 MCP 服务器配置。

主要功能点

MCP 服务器配置管理: 集中管理和维护 MCP 服务器的配置信息。
版本控制: 记录和回溯服务器配置的历史版本，方便配置变更管理。
配置预设 (Profile): 保存和加载服务器配置预设，快速切换不同配置方案。
多客户端支持: 支持管理多个 MCP 客户端（如 Claude Desktop 等）的服务器配置。
伴侣 MCP 服务器: 提供可通过 MCP 协议调用的工具，允许 LLM 客户端（如 Claude）远程管理服务器配置，例如启用/禁用服务器、保存配置、加载预设等。

安装步骤

确保已安装 Python 和 pip。

打开终端，运行以下命令安装 'mcp-serverman':

pip install mcp-serverman

服务器配置 (伴侣 MCP 服务器)

要将 'mcp-serverman' 的伴侣 MCP 服务器注册到 MCP 客户端（例如 Claude），您需要在客户端的 MCP 服务器配置中添加一个新的服务器项。以下是一个配置示例 (JSON 格式):

{
  "servers": {
    "mcp-serverman-companion": {  // 服务器名称，可以自定义
      "command": "mcp",          // 启动命令，这里假设 'mcp' 命令在您的 PATH 环境变量中可用 (mcp 包安装后通常会自动加入)
      "args": [                  // 启动参数
        "run",                   // mcp 命令的子命令，用于运行 MCP 服务器
        "mcp_tool_server.py"      // 伴侣 MCP 服务器脚本的路径，相对于 mcp-serverman 包的安装目录
      ]
    }
    // ... 其他已有的服务器配置 ...
  }
}

重要说明:

上述配置中的 '"command": "mcp"' 假设您已经安装了 'mcp' Python 包，并且 'mcp' 命令可以通过您的 PATH 环境变量访问。'mcp' 包是 'mcp-serverman' 的依赖项，通常在安装 'mcp-serverman' 时会自动安装。
'"args": ["run", "mcp_tool_server.py"]' 中的 'mcp_tool_server.py' 脚本位于 'mcp-serverman' 包的数据目录下。实际路径会根据您的 Python 环境而有所不同。您可以使用命令 'mcp-serverman companion --client <client_short_name>' 自动注册伴侣服务器到指定客户端配置中，命令会自动查找正确的脚本路径和 'mcp' 命令路径。
'<client_short_name>' 需要替换为您要配置的客户端的简称，例如 'claude'。您可以使用 'mcp-serverman client list' 命令查看已注册的客户端简称。

基本使用方法 (命令行工具)

安装完成后，您可以使用 'mcp-serverman' 命令在终端中进行操作。以下是一些常用命令示例：

列出所有服务器:
```
mcp-serverman list
```

启用服务器:

mcp-serverman enable <server_name>

禁用服务器:

mcp-serverman disable <server_name>

保存当前服务器配置版本:

mcp-serverman save <server_name> --comment "本次配置变更的描述"

加载配置预设:

mcp-serverman preset load <preset_name>

注册伴侣 MCP 服务器到 Claude 客户端:

mcp-serverman companion --client claude

更多详细用法，请参考仓库的 Manual.md 文件。

关键词