MCP Client Configuration Server

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 app：Claude AI 桌面应用

**注意：**不再支持 Cursor，因为它没有使用标准配置文件来存储 MCP 设置。Cursor 似乎以一种我们难以修改的方式存储其 MCP 配置，因此与此配置服务基于文件的处理方式不兼容。

用法

此服务在以下场景中特别有用：

1. 在多个客户端之间管理 MCP 服务：只需配置一次服务，即可将其部署到多个客户端
2. 自动化配置：脚本可以使用此服务，以编程方式管理 MCP 配置
3. 故障排查：轻松检查已配置的服务及其设置

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

下面是一段简单的提示词，可用于让 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"
}

2. 然后将相同的配置添加到 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": { /* new config */ },
       "allow_override": true
     }
     

3. 不支持的平台

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

最佳实践

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