MCP Config Manager

🚀 MCP 配置管理器

MCP 配置管理器是一款用於模型上下文協議（MCP）服務器的配置管理工具。它能夠為不同客戶端（如 Claude Desktop 和 VSCode 擴展 (Cline 和 Roo)）提供 MCP 服務器配置管理功能，極大地提升了配置管理的效率和便捷性。

🚀 快速開始

MCP 配置管理器可幫助你輕鬆管理 MCP 服務器的配置，支持多種客戶端，能自動檢測配置文件路徑，還具備環境變量驗證等功能。

✨ 主要特性

• 自動檢測不同環境下的配置文件路徑，無需手動查找，節省時間和精力。
• 支持 Claude Desktop 和 VSCode 擴展（Cline 和 Roo），滿足多樣化的使用需求。
• 進行環境變量驗證，確保配置的準確性和安全性。
• 具備基本通用配置管理功能，操作簡單便捷。
• 為 VSCode 擴展（Cline 和 Roo）提供特定設置（disabled、autoApprove），滿足個性化需求。

📦 安裝指南

使用以下命令進行安裝：

pip install mcp-config-manager

💻 使用示例

基礎用法

from mcp_config_manager import add_to_config

# 定義所需的環境變量
REQUIRED_ENV_VARS = ["API_KEY", "API_URL"]

# 添加到 Claude Desktop 配置
add_to_config(
    server_name="my-mcp-server",
    required_env_vars=REQUIRED_ENV_VARS,
    config_type="claude"
)

# 添加到 Cline 配置（VSCode 擴展）
add_to_config(
    server_name="my-mcp-server",
    required_env_vars=REQUIRED_ENV_VARS,
    config_type="cline"  # 將包含 disabled=False 和 autoApprove 設置
)

# 添加到 Roo 配置（VSCode 擴展）
add_to_config(
    server_name="my-mcp-server",
    required_env_vars=REQUIRED_ENV_VARS,
    config_type="roo"  # 將包含 disabled=False 和 autoApprove 設置
)

高級用法

# 使用自定義環境變量
env_vars = {
    "API_KEY": "my-key",
    "API_URL": "https://api.example.com"
}

add_to_config(
    server_name="my-mcp-server",
    required_env_vars=REQUIRED_ENV_VARS,
    env_vars=env_vars,
    config_type="cline"
)

📚 詳細文檔

配置文件位置

該包會自動檢測適當的配置文件路徑，具體如下：

VSCode 擴展設置

當為 VSCode 擴展（Cline 或 Roo）添加配置時，會自動包含以下附加設置：

{
  "disabled": false,  // 服務器默認啟用
  "autoApprove": []  // 列表中是要自動批准的操作
}

開發

如果你想參與項目開發，可按以下步驟進行：

1. 克隆倉庫。
2. 安裝開發依賴：pip install -e ".[dev]"。
3. 運行測試：pytest。
4. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，詳細信息請參閱 LICENSE 文件。