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 文件。