关键词

LLM工具管理AI客户端集成MCP网关服务器代理配置同步

项目简介

MCP服务器管理器（'mcpsm'）是一款强大的命令行工具，旨在简化跨多个AI客户端（如Claude Desktop, Cursor, Windsurf, VS Code等）管理Model Context Protocol (MCP) 服务器的复杂性。它采用独特的网关模式，将所有MCP服务器整合到一个单一的接口下，使得LLM客户端只需连接到'mcpsm'网关即可访问所有已配置的MCP服务器及其工具，实现配置的自动化同步、服务器测试和状态监控。本质上，'mcpsm'自身作为一个MCP服务器运行，但它的功能来自于它所代理的其他MCP服务器。

主要功能点

  • 统一网关: 'mcpsm'作为一个中转站，将多个MCP服务器的功能聚合起来，LLM客户端只需连接到'mcpsm'这一个网关即可访问所有注册的MCP服务器。
  • 集中管理: 告别分散的配置文件，通过'mcpsm'集中添加、编辑、删除和启用/禁用MCP服务器。
  • 自动化同步: 任何对'mcpsm'配置的更改都会自动同步到所有连接的AI客户端，无需手动修改多个JSON文件。
  • 内置测试: 在部署到工作流之前，可以并行测试所有MCP服务器，确保它们正常工作。
  • 资源监控: 追踪每个服务器和每个工具的上下文（Token）使用情况。
  • 配置文件支持: 根据项目或开发环境创建不同的服务器配置文件，轻松切换不同的服务器集合。
  • 后台运行: 可作为守护进程在后台运行网关服务，支持开机自动启动，确保服务持续可用。
  • 客户端集成: 支持与Claude Desktop, Cursor, Windsurf, VS Code等主流AI客户端无缝集成，简化连接过程。

安装步骤

  1. 安装 Node.js: 确保您的系统已安装 Node.js 18.0.0 或更高版本。您可以在终端运行 'node -v' 进行检查。
  2. 通过 npm 安装: 打开终端或命令行工具，运行以下命令全局安装 MCP 服务器管理器： 
    npm install -g mcp-server-manager
  3. 验证安装: 运行 'mcpsm --version'，如果显示版本号（例如 '2.0.0'），则表示安装成功。

服务器配置

MCP服务器管理器（'mcpsm'）自身就是一个MCP服务器（网关），因此您的LLM客户端需要配置连接到这个'mcpsm'网关。

您LLM客户端的配置通常是JSON格式，需要包含以下信息，指引客户端连接到'mcpsm'网关。以下是常用的配置示例和说明：

  • 对于支持 'command' 和 'args' 的客户端 (如 Claude Desktop, Cursor, Windsurf, VS Code): 在您的客户端配置文件中，找到 'mcpServers' 部分（或类似名称），添加一个指向 'mcpsm' 网关的条目： 
    {
  "mcpServers": {
    "mcpsm-gateway": {
      "command": "npx",
      "args": ["-y", "supergateway", "--streamableHttp", "http://localhost:8850/mcp"]
    }
  }
}
    • 'mcpsm-gateway': 这是您为 MCP 服务器管理器在客户端中定义的名称，可以自定义。
    • 'command': 配置为 'npx'。
    • 'args': 配置为 '["-y", "supergateway", "--streamableHttp", "http://localhost:8850/mcp"]'。
      • 此参数列表告诉客户端使用 'supergateway'（一个'mcpsm'用来将自身暴露为MCP服务器的辅助工具）连接到 'http://localhost:8850/mcp'。
      • 'http://localhost:8850/mcp' 是 MCP 服务器管理器默认运行的地址和端口。如果您的 'mcpsm' 网关运行在其他端口，请将 '8850' 替换为实际端口。

请查阅您的特定LLM客户端的文档，了解如何编辑其 MCP 服务器配置。通常，您可以通过 'mcpsm clients connect <client-id>' 命令让'mcpsm'自动完成此配置。

基本使用方法

  1. 启动交互式界面 (TUI): 在终端中运行 'mcpsm'，这将启动一个美观、直观的终端用户界面。您可以使用键盘快捷键（如方向键、'Enter'、'Q' 等）进行服务器管理、查看状态等操作。 
    mcpsm
  2. 添加 MCP 服务器: 在 TUI 界面中，按下 'A' 键可以添加新的本地或远程 MCP 服务器。按照提示输入服务器 ID、名称、命令及其参数（对于本地服务器）或 URL（对于远程服务器）。
  3. 连接 AI 客户端: 使用 CLI 命令 'mcpsm clients connect <client-id>' 来自动配置您的 AI 客户端。例如，连接 Claude Desktop 客户端： 
    mcpsm clients connect claude
    'mcpsm' 会自动修改 Claude Desktop 的配置文件，使其连接到 'mcpsm' 网关。对于其他支持的客户端，只需替换 '<client-id>' (如 'cursor', 'windsurf', 'vscode')。
  4. 测试服务器: 在 TUI 界面中，按下 'X' 键可以并行测试所有已配置的 MCP 服务器是否正常工作，并发现其提供的工具。
  5. 后台运行网关 (可选): 如果您希望 'mcpsm' 网关在后台持续运行，即使关闭终端，可以使用守护进程模式启动： 
    mcpsm daemon start
    如果您希望 'mcpsm' 网关随系统开机自动启动，可以启用开机自启功能： 
    mcpsm daemon startup enable
    您可以使用 'mcpsm daemon status' 查看守护进程的状态。

信息

分类

开发者工具

访问项目