Landicefu MCP Client Configuration Server

🚀 MCP 客戶端配置服務器

MCP 客戶端配置服務器可助力管理不同 MCP 客戶端的配置。它提供了一系列工具，用於檢索、列出、添加和刪除客戶端配置文件中的服務器配置。同時，該服務器能夠依據操作系統（Windows 或 macOS）以及指定的客戶端，自動檢測合適的配置文件路徑。

🚀 快速開始

本服務器可幫助你便捷地管理 MCP 客戶端的配置，通過一系列工具，你能輕鬆對客戶端配置文件中的服務器配置進行操作。

✨ 主要特性

• 依據操作系統（Windows 或 macOS）和指定客戶端自動檢測配置文件路徑。
• 提供檢索、列出、添加和刪除客戶端配置文件中服務器配置的工具。
• 支持多客戶端配置管理，確保數據同步、集中管理和版本控制。
• 配置文件修改後以美化 JSON 格式保存。
• 具備錯誤處理機制，針對找不到配置文件等情況提供相應提示。
• 若配置文件和目錄不存在，會自動創建。

📦 安裝指南

你可以通過以下兩種方式進行安裝：

# 從npm安裝
npm install -g @landawn/mcp-config-server

# 或者使用yarn
yarn add @landawn/mcp-config-server

📚 詳細文檔

要將此服務器用作依賴項，請確保它已正確安裝。有關配置和使用的詳細信息，請參閱項目文檔。

📋 支持的客戶端

Windows

macOS

📈 使用場景

• 數據同步：在多個客戶端之間同步配置，確保一致性。
• 集中管理：在一個地方管理所有客戶端的配置，便於維護和更新。
• 版本控制：將配置文件納入版本控制系統，記錄變更歷史。

💻 使用示例

基礎用法

檢索配置

const { getConfig } = require('@landawn/mcp-config-server');

getConfig('cline', 'existing-server').then(config => {
    console.log('Retrieved configuration:', config);
}).catch(err => {
    console.error('Error retrieving configuration:', err);
});

列舉所有服務器

const { listConfigs } = require('@landawn/mcp-config-server');

listConfigs('cline').then.servers => {
    console.log('List of servers:', servers);
}).catch(err => {
    console.error('Error listing configurations:', err);
});

高級用法

添加新服務器

const { addConfig } = require('@landawn/mcp-config-server');

addConfig('cline', 'new-server', {
    "api-key": "your-api-key",
    "endpoint": "http://localhost:3000"
}).then(message => {
    console.log('Success message:', message);
}).catch(err => {
    console.error('Error adding configuration:', err);
});

更新現有服務器

const { updateConfig } = require('@landawn/mcp-config-server');

updateConfig('cline', 'existing-server', {
    "allow_override": true,
    "new-setting": "value"
}).then(config => {
    console.log('Updated configuration:', config);
}).catch(err => {
    console.error('Error updating configuration:', err);
});

刪除服務器

const { removeConfig } = require('@landawn/mcp-config-server');

removeConfig('cline', 'existing-server').then(message => {
    console.log('Success message:', message);
}).catch(err => {
    console.error('Error removing configuration:', err);
});

🔧 技術細節

• 服務器會依據操作系統和指定客戶端自動檢測配置文件路徑。
• 所有配置文件在修改後都會以美化 JSON 格式保存。
• 具備錯誤處理機制，針對找不到配置文件等情況提供相應提示。
• 若配置文件和目錄不存在，會自動創建。

❓ 常見問題

配置文件未找到

• 添加新服務器時會自動創建配置文件。
• 其他操作在找不到配置文件時會顯示錯誤消息。

服務器已存在

• 更新現有服務器時需要將allow_override設置為true。
• 示例：

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

不受支持的平臺

• 目前僅支持 Windows 和 macOS。
• Linux 支持可能在未來的版本中添加。

💡 最佳實踐

⚠️ 重要提示

在使用本服務器時，請仔細閱讀文檔，確保操作正確。

💡 使用建議

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