MCP Client Configuration Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Referenced as a potential integration via the android-adb-mcp-server in configuration examples.

  • Referenced in usage examples for copying the brave-search MCP server configuration between clients.

  • Detects and manages configuration files on macOS systems, using platform-specific paths for client configuration management.

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 :人工智能浏览器
  • Claude app :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.

人工智能助手将在后台执行以下步骤:

  1. 从 Roo 代码获取服务器配置:
// 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 服务器配置。

工具

获取配置路径

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

参数:

  • client (必填):客户名称(cline、roo_code、windsurf、claude)

返回:

  • 配置文件的绝对路径

获取配置

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

参数:

  • client (必填):客户名称(cline、roo_code、windsurf、claude)

返回:

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

列表服务器

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

参数:

  • client (必填):客户名称(cline、roo_code、windsurf、claude)

返回:

  • 服务器名称数组

获取服务器配置

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

参数:

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

返回:

  • 指定服务器的 JSON 配置

添加服务器配置

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

参数:

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

例子:

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

返回:

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

删除服务器配置

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

参数:

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

返回:

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

实现细节

  • 服务器根据操作系统(Windows 或 macOS)和指定的客户端检测适当的配置文件路径。
  • 所有配置文件修改后均以美化的JSON格式维护。
  • 当配置文件不存在或无法访问时,提供错误处理。
  • 如果配置文件和目录不存在,服务器会自动创建。
  • 每个客户端的配置路径:
    • 窗户
      • Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
      • Roo 代码: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
      • 风帆: %APPDATA%\WindSurf\mcp_settings.json
      • 克劳德: %APPDATA%\Claude\claude_desktop_config.json
    • macOS 系统
      • Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
      • Roo 代码: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
      • 风帆: ~/.codeium/windsurf/mcp_config.json
      • 克劳德: ~/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 支持。

最佳实践

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

一种帮助管理和同步不同 AI 助手客户端(Cline、Roo Code、WindSurf、Claude)之间的 MCP 服务器配置的工具,可自动从客户端配置文件中检索、列出、添加和删除服务器配置的过程。

  1. Installation
    1. Configuration
      1. Supported Clients
        1. Usage
          1. Example: Copying a server configuration from Roo Code to Claude app
        2. Tools
          1. get_configuration_path
          2. get_configuration
          3. list_servers
          4. get_server_configuration
          5. add_server_configuration
          6. remove_server_configuration
        3. Implementation Details
          1. Troubleshooting
            1. Common Issues
            2. Best Practices
          ID: aa10ltj5b6