MCP 客户端配置服务器

此 MCP 服务器帮助管理不同 MCP 客户端的配置。它提供工具来从客户端配置文件中检索、列出、添加和删除服务器配置。服务器会自动检测基于操作系统（Windows 或 macOS）和指定客户端的适当配置文件路径。

安装

# 从 npm 安装
npm install -g @landicefu/mcp-client-configuration-server

# 或者使用 npx 运行，无需安装
npx @landicefu/mcp-client-configuration-server

配置

要在您的 AI 助手中使用此 MCP 服务器，请将其添加到您的 MCP 设置配置中：

{
  "mcpServers": {
    "mcp-client-configuration": {
      "command": "npx",
      "args": ["-y", "@landicefu/mcp-client-configuration-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

支持的客户端

• Cline: 由 Claude 驱动的编码助手
• Roo Code: 具有 AI 功能的代码编辑器
• WindSurf: AI 驱动的浏览器
• Claude app: Claude AI 的桌面应用程序

注意： Cursor 不再受支持，因为它没有使用标准的 MCP 设置配置文件。Cursor 似乎以我们无法轻易修改的方式存储其 MCP 配置，使其与此配置服务器基于文件的方法不兼容。

用法

此服务器特别适用于：

1. 跨多个客户端管理 MCP 服务器：配置一次服务器并将其部署到多个客户端
2. 自动化配置：脚本可以使用此服务器以编程方式管理 MCP 配置
3. 故障排除：轻松检查配置了哪些服务器及其设置

示例：将服务器配置从 Roo Code 复制到 Claude app

这是一个简单的提示，您可以与 AI 助手一起使用，将 MCP 服务器配置从 Roo Code 复制到 Claude 桌面应用程序：

请将 "brave-search" MCP 服务器配置从 Roo Code 复制到我的 Claude 桌面应用程序。

AI 助手将在后台执行以下步骤：

1. 从 Roo Code 获取服务器配置：

// 首先，从 Roo Code 获取服务器配置
{
  "client": "roo_code",
  "server_name": "brave-search"
}

2. 然后将相同的配置添加到 Claude：

// 然后使用相同的设置将其添加到 Claude
{
  "client": "claude",
  "server_name": "brave-search",
  "json_config": {
    // 从上一步检索的配置
  },
  "allow_override": true
}

这使您可以轻松地跨不同的 AI 助手同步您的 MCP 服务器配置。

工具

get_configuration_path

检索指定客户端的配置文件的路径。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)

返回值：

• 配置文件的绝对路径

get_configuration

检索指定客户端的完整配置。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)

返回值：

• 来自客户端配置文件的完整 JSON 配置

list_servers

列出在指定客户端的配置中配置的所有服务器名称。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)

返回值：

• 服务器名称数组

get_server_configuration

从客户端配置中检索特定服务器的配置。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)
• server_name (必需): 要检索的服务器的名称

返回值：

• 指定服务器的 JSON 配置

add_server_configuration

在客户端配置文件中添加或更新服务器配置。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)
• server_name (必需): 要添加或更新的服务器的名称
• json_config (必需): JSON 格式的服务器配置

示例：

{
  "command": "npx",
  "args": ["-y", "@landicefu/android-adb-mcp-server"],
  "env": {},
  "disabled": false,
  "alwaysAllow": []
}

返回值：

• 包含更新配置的成功消息

remove_server_configuration

从客户端配置文件中删除服务器配置。

参数：

• client (必需): 客户端名称 (cline, roo_code, windsurf, claude)
• server_name (必需): 要删除的服务器的名称

返回值：

• 删除的配置或服务器未找到的消息

实现细节

• 服务器检测基于操作系统（Windows 或 macOS）和指定客户端的适当配置文件路径。
• 所有配置文件在修改后都以美化的 JSON 格式维护。
• 为配置文件不存在或无法访问的情况提供错误处理。
• 如果配置文件和目录不存在，服务器会自动创建它们。
• 每个客户端的配置路径：
  • Windows:
    • Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
    • Roo Code: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
    • WindSurf: %APPDATA%\WindSurf\mcp_settings.json
    • Claude: %APPDATA%\Claude\claude_desktop_config.json
  • macOS:
    • Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Roo Code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
    • WindSurf: ~/.codeium/windsurf/mcp_config.json
    • Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

故障排除

常见问题

1. 找不到配置文件

   • 添加新服务器时，如果配置文件不存在，将自动创建。
   • 对于其他操作，如果配置文件不存在，您将收到一条错误消息。

2. 服务器已存在

   • 添加已存在的服务器时，您需要将 allow_override 设置为 true 才能更新它。
   • 示例：

     {
       "client": "cline",
       "server_name": "existing-server",
       "json_config": { /* new config */ },
       "allow_override": true
     }
     

3. 不支持的平台

   • 目前，仅支持 Windows 和 macOS。
   • Linux 支持可能会在未来的版本中添加。

最佳实践

• 在尝试更新或删除服务器之前，始终检查服务器是否存在。
• 在客户端之间使用一致的服务器名称，以简化管理。
• 考虑在服务器配置中使用环境变量来存储敏感信息。