金大哥 - mcp-client-configuration-server MCP 详情

article

README

🚀 MCP 客户端配置服务器

MCP 客户端配置服务器旨在助力管理不同 MCP 客户端的配置。它提供了一系列实用工具，可用于检索、列出、添加和删除客户端配置文件中的服务器配置。同时，该服务器能够自动检测适配的操作系统（Windows 或 macOS），并精准定位指定客户端的合适配置文件路径。

🚀 快速开始

此 MCP 服务器可助力您轻松管理不同 MCP 客户端的配置，以下是使用前的安装和配置步骤。

📦 安装指南

您可以选择以下两种方式安装此 MCP 服务器：

# 从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 配置存储在我们无法轻易修改的方式中，这使其与基于文件的方法不兼容。

适用场景

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

跨多个客户端管理 MCP 服务器：配置一次服务器即可部署到多个客户端。
自动化配置：脚本可以使用此服务器以编程方式管理 MCP 配置。
故障排除：轻松检查已配置的服务器及其设置。

💻 使用示例

基础用法

本服务器可帮助您跨多个客户端管理 MCP 服务器，配置一次即可部署到多个客户端。以下是使用脚本以编程方式管理 MCP 配置的示例（假设您已完成安装和配置）：

# 使用npx运行服务器
npx @landicefu/mcp-client-configuration-server

高级用法

在故障排除时，您可以使用此服务器轻松检查已配置的服务器及其设置。例如，您可以编写脚本定期检查服务器配置是否正确：

# 示例脚本，这里假设您有一个检查脚本 check_mcp_config.sh
./check_mcp_config.sh

🔧 技术细节

配置文件路径检测

该服务器会根据操作系统（Windows 或 macOS）和指定客户端检测合适的配置文件路径。各客户端的配置路径如下：

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

配置文件保存

所有配置文件在修改后都会以美化 JSON 格式保存。

错误处理

提供了对找不到配置文件或无法访问配置文件的情况进行错误处理。如果配置文件不存在，服务器会自动创建它们和所需的目录。

❓ 常见问题

配置文件未找到

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

服务器已存在

当尝试更新或删除已存在的服务器时，需要设置allow_override为true以进行更新。
示例：

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

不受支持的平台

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

💡 使用建议

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

mcp-client-configuration-server