mcpField
C
Claude Desktop Config Manager

Claude Desktop Config Manager

Local
github.com/eversonlAI & Agents3Updated 82w ago

About Claude Desktop Config Manager

Claude Desktop Config Manager is a command-line tool for managing Claude Desktop MCP configurations. It is intended for users who need to toggle servers, save presets, or maintain configuration files, with validation and backup features included.

Key features

  1. 01Enable or disable MCP servers
  2. 02Create and load configuration presets
  3. 03Select custom MCP configurations
  4. 04Back up, restore, and manage backups
  5. 05Validate and repair configuration files

Use cases

  1. 01Switch enabled MCP servers for different tasks
  2. 02Save presets for different configurations
  3. 03Back up changes and restore configurations when needed
  4. 04Fix common JSON issues in the config file

MCP support

The tool directly edits Claude Desktop's configuration file and separates enabled from disabled MCP servers. It does not provide an MCP server endpoint.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Claude Desktop Config Manager

A lightweight, command-line tool for managing Claude Desktop MCP (Model Context Protocol) configurations. This tool makes it easy to toggle MCP servers on and off, create preset configurations, and manage backups.

Features

  • Toggle MCP Servers: Enable or disable individual MCP servers
  • Custom Configurations: Select which MCPs to enable based on your needs
  • Preset Management: Save and load configuration presets
  • Backup & Restore: Create timestamped backups and restore when needed
  • Config Validation: Check and fix JSON syntax or structure issues
  • Color-Coded Interface: Easy-to-read, color-coded console interface

Requirements

  • Node.js (v12 or higher)
  • Claude Desktop installed

Installation

  1. Clone this repository or download the claude-config-manager.js file
  2. Open the file in a text editor
  3. Update the CLAUDE_DIR value at the top to match your Claude installation path
  4. Save the file

Usage

Run the tool from the command line:

node claude-config-manager.js
Main Menu Options
  1. Toggle MCP Servers: Enable or disable individual MCPs
  2. Save Configuration as Preset: Save your current configuration for later use
  3. Load Preset: Load a previously saved configuration
  4. Create Custom Configuration: Select which MCPs to enable, with intelligent recommendations
  5. Backup & Restore: Create manual backups or restore from existing backups
  6. Check/Fix Config File: Validate and repair your configuration file
  7. Enable All MCPs: Quickly enable all available MCPs
  8. Exit: Close the application
Creating Custom Configurations

The tool provides intelligent recommendations for essential MCPs and allows you to create custom configurations:

  • Enter specific numbers (e.g., "1,3,5") to select individual MCPs
  • Enter "r" to use recommended essential MCPs
  • Enter "all" to enable all available MCPs
Backup & Restore

The tool automatically creates backups whenever you change your configuration and provides options to:

  • Create manual timestamped backups
  • Restore from any backup
  • Manage (view/delete) existing backups

How It Works

The tool directly manipulates the Claude Desktop configuration file, organizing MCPs into two categories:

  • mcpServers: Active/enabled MCPs
  • disabledMcpServers: Inactive/disabled MCPs

This organization allows Claude Desktop to only use enabled MCPs while keeping disabled ones readily available for future use.

Troubleshooting

If you encounter JSON syntax errors in your configuration file, the tool's "Check/Fix Config File" option can automatically repair common issues like:

  • Trailing commas
  • Missing commas between properties
  • Invalid structure

License

MIT License - See LICENSE file for details

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.