MCP Client Configuration Server

🚀 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 配置存儲在我們無法輕易修改的方式中，這使其與基於文件的方法不兼容。

適用場景

此服務器特別適用於以下場景：

1. 跨多個客戶端管理 MCP 服務器：配置一次服務器即可部署到多個客戶端。
2. 自動化配置：腳本可以使用此服務器以編程方式管理 MCP 配置。
3. 故障排除：輕鬆檢查已配置的服務器及其設置。

💻 使用示例

基礎用法

本服務器可幫助您跨多個客戶端管理 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 的支持。

💡 使用建議

• 在更新或刪除服務器之前，始終檢查是否存在該服務器。
• 使用一致的服務器名稱跨客戶端進行管理以使管理更輕鬆。
• 考慮在服務器配置中使用環境變量來存儲敏感信息。