Manage MCP server configurations easily across environments with automated detection and VSCode extension support
MCP Config Manager is an essential tool in the Model Context Protocol (MCP) ecosystem, designed to simplify configuration management for various clients like Claude Desktop and VSCode extensions such as Cline and Roo. By leveraging MCP, this server ensures seamless integration between AI applications and data sources/tools, making it a crucial component for developers building advanced AI workflows.
MCP Config Manager offers several key features that enhance the usability and flexibility of AI application configurations:
Automated Configuration Path Detection: The library automatically detects the appropriate configuration file locations across different environments (EC2, macOS, Windows), ensuring that developers can focus on setting up their applications without worrying about file paths.
Support for Multiple MCP Clients: It supports popular clients like Claude Desktop and VSCode extensions (Cline and Roo), providing a unified approach to managing configurations for these tools.
Environment Variable Validation: The package validates environment variables, making sure that necessary parameters are set correctly before the server is configured.
Generic Configuration Management Functions: Provides high-level functions to manage configurations easily, abstracting away complex lower-level details.
VSCode Extension-specific Settings: Adds default settings such as disabled
and autoApprove
for VSCode extensions like Cline and Roo, ensuring that these tools can be seamlessly integrated into the development workflow.
MCP Config Manager leverages the Model Context Protocol to manage configurations. This protocol standardizes how AI applications interact with data sources and tools, ensuring consistency across different implementations. The architecture of this server is designed to facilitate seamless integration by following these key principles:
Protocol Flow: The server acts as a bridge between AI applications (like Claude Desktop) and MCP clients (such as Cline or Roo). This flow is illustrated in the given Mermaid diagram below.
graph TD
A[AI Application] -->|MCP Client| B[MCP Protocol]
B --> C[MCP Server]
C --> D[Data Source/Tool]
style A fill:#e1f5fe
style C fill:#f3e5f5
style D fill:#e8f5e8
MCP Client Compatibility: The server supports a range of clients, including Claude Desktop and VSCode extensions (Cline and Roo). This compatibility matrix highlights the support status for each tool.
MCP Client | Resources | Tools | Prompts | Status |
---|---|---|---|---|
Claude Desktop | ✅ | ✅ | ✅ | Full Support |
Continue | ✅ | ✅ | ✅ | Full Support |
Cursor | ❌ | ✅ | ❌ | Tools Only |
Installing MCP Config Manager is straightforward and can be done via pip:
pip install mcp-config-manager
Once installed, you can immediately start managing configurations for your preferred AI applications. Here’s how to add a configuration entry:
from mcp_config_manager import add_to_config
# Define your required environment variables
REQUIRED_ENV_VARS = ["API_KEY", "API_URL"]
# Add to Claude Desktop configuration
add_to_config(
server_name="my-mcp-server",
required_env_vars=REQUIRED_ENV_VARS,
config_type="claude"
)
# Add to Cline configuration (VSCode extension)
add_to_config(
server_name="my-mcp-server",
required_env_vars=REQUIRED_ENV_VARS,
config_type="cline" # Will include disabled=False and autoApprove settings
)
# Add to Roo configuration (VSCode extension)
add_to_config(
server_name="my-mcp-server",
required_env_vars=REQUIRED_ENV_VARS,
config_type="roo" # Will include disabled=False and autoApprove settings
)
# With custom environment variables
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"
)
In this scenario, developers can integrate MCP Config Manager to streamline the setup process for users of Claude Desktop. By configuring a dedicated MCP server and setting up environment variables correctly, end-users can quickly start using advanced features provided by MCP without manual configuration.
For developers working on tools like Cline or Roo, integrating with an MCP server allows for automated tests that validate configurations. This ensures that the tool is always aligned with the latest settings and API endpoints, reducing potential integration issues during development.
To fully leverage the capabilities of this library, integrate it into your AI application setup by adding a configuration block to manage MCP servers:
{
"mcpServers": {
"[server-name]": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-[name]"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}
MCP Config Manager provides excellent performance and compatibility across different environments. The following table summarizes the supported configurations:
The package automatically detects the appropriate configuration file paths for various operating systems:
Claude Desktop
~/.vscode-server/data/User/globalStorage/anthropic.claude/settings/claude_desktop_config.json
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%/Claude/claude_desktop_config.json
VSCode Extensions
Cline
~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Roo
~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
For advanced users and security-conscious developers, MCP Config Manager offers several configuration options:
Custom Environment Variables: Allow setting custom environment variables to tailor configurations according to individual needs.
Security Settings: Implement proper security practices by validating environment variables and ensuring that all configurations are secure.
The package automatically detects the correct configuration file paths based on the operating system, simplifying setup across EC2, macOS, and Windows.
MCP Config Manager supports Claude Desktop and VSCode extensions like Cline and Roo. Currently, Continue has full support, while Cursor is limited to tool integration only.
Yes, you can define custom environment variables when calling add_to_config
to tailor configurations according to your specific requirements.
Settings like disabled
and autoApprove
are automatically included in the configuration entries for Cline and Roo, ensuring seamless integration into the development environment.
The library has been optimized to ensure minimal overhead during setup and runtime, providing a smooth user experience without compromising on performance.
To contribute to MCP Config Manager, follow these steps:
git clone https://github.com/example/mcp-config-manager.git
pip install -e ".[dev]"
pytest
Make sure your contributions adhere to the existing coding standards and guidelines.
For further information on Model Context Protocol, visit the official documentation at https://modelcontextprotocol.org.
By incorporating MCP Config Manager into their development process, AI application developers can ensure robust integration capabilities while leveraging MCP's standardized protocol for seamless connectivity and enhanced functionality.
RuinedFooocus is a local AI image generator and chatbot image server for seamless creative control
Learn to set up MCP Airflow Database server for efficient database interactions and querying airflow data
Simplify MySQL queries with Java-based MysqlMcpServer for easy standard input-output communication
Build stunning one-page websites track engagement create QR codes monetize content easily with Acalytica
Explore CoRT MCP server for advanced self-arguing AI with multi-LLM inference and enhanced evaluation methods
Access NASA APIs for space data, images, asteroids, weather, and exoplanets via MCP integration