MCP Config Manager

MCP Config Manager

site icon
2025.02.04 1
Python配置管理开发工具开发效率
MCP Config Manager 是一个用于管理 Model Context Protocol (MCP) 服务器配置的工具包。它提供了自动检测不同环境下的配置文件路径、支持 Claude Desktop 和 VSCode 扩展(Cline 和 Roo)的配置管理、环境变量验证以及通用配置管理功能。
View on GitHub

Overview

基本能力

产品定位

MCP Config Manager 是一个专注于管理 MCP 服务器配置的工具,旨在简化不同客户端(如 Claude Desktop 和 VSCode 扩展)的配置管理流程。

核心功能

  • 自动检测不同环境下的配置文件路径
  • 支持 Claude Desktop 和 VSCode 扩展(Cline 和 Roo)的配置管理
  • 环境变量验证
  • 通用配置管理函数
  • VSCode 扩展特定设置(如 disabled 和 autoApprove)

适用场景

  • 开发者在不同环境中配置 MCP 服务器
  • 管理多个客户端的配置(如 Claude Desktop 和 VSCode 扩展)
  • 自动化环境变量验证和配置管理

工具列表

  • add_to_config:用于添加配置到指定客户端(Claude Desktop、Cline 或 Roo)

常见问题解答

  • 配置文件路径自动检测失败:确保运行环境正确,并检查路径是否存在
  • 环境变量验证失败:确保所有必需的环境变量已正确设置

使用教程

使用依赖

安装 Python 环境

安装教程

pip install mcp-config-manager

调试方式

  1. 克隆仓库
  2. 安装开发依赖:pip install -e ".[dev]"
  3. 运行测试:pytest
  4. 提交拉取请求

配置示例

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 设置
)

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。