MCP客户端配置服务器

Name: MCP客户端配置服务器
Author: landicefu

作者：landicefu2 星标更新：2025-03-12

项目介绍

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 应用: 用于 Claude AI 的桌面应用

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

使用

此服务器特别适用于：

跨多个客户端管理 MCP 服务器: 在一个地方配置服务器并部署到多个客户端
自动化配置: 脚本可以使用此服务器来编程管理 MCP 配置
故障排除: 轻松检查哪些服务器已配置及其设置

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

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

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

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

获取来自 Roo Code 的服务器配置：

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

然后将相同的配置添加到 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

故障排除

常见问题

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

服务器已存在

当添加已存在的服务器时，您需要将 allow_override 设置为 true 来更新它。

示例：

{
  "client": "cline",
  "server_name": "existing-server",
  "json_config": { /* 新配置 */ },
  "allow_override": true
}

不受支持的平台
- 目前仅支持 Windows 和 macOS。
- Linux 支持可能会在未来版本中添加。

最佳实践

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