MCP 客户端配置服务器

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

安装

# Install from npm
npm install -g @landicefu/mcp-client-configuration-server

# Or use npx to run without installing
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应用: Claude AI的桌面应用程序

注意： Cursor不再被支持，因为它不使用标准的MCP设置配置文件。Cursor似乎以一种我们难以修改的方式存储其MCP配置，这使得它与本配置服务器基于文件的方法不兼容。

使用方法

此服务器特别适用于以下场景：

1. 跨多个客户端管理MCP服务器：配置一次服务器，并部署到多个客户端
2. 自动化配置：脚本可以使用此服务器程序化地管理MCP配置
3. 故障排除：轻松检查已配置的服务器及其设置

示例：从Roo Code复制服务器配置到Claude应用

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

Please copy the "brave-search" MCP server configuration from Roo Code to my Claude desktop app.

AI助手会在幕后执行以下步骤：

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

// First, get the server configuration from Roo Code
{
  "client": "roo_code",
  "server_name": "brave-search"
}

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

// Then add it to Claude with the same settings
{
  "client": "claude",
  "server_name": "brave-search",
  "json_config": {
    // Configuration retrieved from previous step
  },
  "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": { /* 新配置 */ },
       "allow_override": true
     }
     

3. 不支持的平台

   • 目前仅支持 Windows 和 macOS。
   • 将来可能会增加对 Linux 的支持。

最佳实践

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