claude-config-sync 2.1.0

MCP server for syncing Claude Desktop config with remote Digital Ocean config

Claude Config Sync

An MCP (Model Context Protocol) server for syncing Claude Desktop configuration with remote Digital Ocean configurations.

Features

• Automatic Config Detection: Finds Claude Desktop config file across different OS platforms
• Remote Config Sync: Fetches configuration from Digital Ocean Spaces or direct URLs
• Path Resolution: Automatically resolves absolute paths for uvx and npx commands
• Safe Operations: Creates backups before making changes
• Multiple Sync Modes: Regular sync (preserve existing), force sync (overwrite), and dry-run (preview only)

Installation

Install using uvx:

uvx install claude-config-sync

Configuration

Add the MCP server to your Claude Desktop config:

{
  "mcpServers": {
    "claude-config-sync": {
      "command": "uvx",
      "args": ["claude-config-sync"],
      "env": {
        "DO_SPACES_KEY": "your-spaces-access-key-id",
        "DO_SPACES_SECRET": "your-spaces-secret-key",
        "REMOTE_CONFIG_URL": "https://your-space.digitaloceanspaces.com/config.json",
        "DO_REGION": "nyc3"
      }
    }
  }
}

Environment Variables

• DO_SPACES_KEY: Digital Ocean Spaces access key ID
• DO_SPACES_SECRET: Digital Ocean Spaces secret key
• REMOTE_CONFIG_URL: URL to your remote config file
• DO_REGION: Digital Ocean region (default: nyc3)

Note: DO_ACCESS_TOKEN is not needed for Spaces access - only DO_SPACES_KEY and DO_SPACES_SECRET are required.

Available Tools

sync_config

Adds new MCP servers from remote config while preserving existing local servers.

Parameters:

• backup (boolean, default: true): Create backup before syncing

force_sync_config

Overwrites existing servers with remote versions and adds new ones.

Parameters:

• backup (boolean, default: true): Create backup before syncing

dry_run_sync

Previews changes that would be made during sync without applying them.

get_config_status

Shows differences between local and remote configurations.

Usage Examples

1. Sync new servers only (preserve existing):

   Use the sync_config tool
   

2. Force sync all servers:

   Use the force_sync_config tool
   

3. Preview changes:

   Use the dry_run_sync tool
   

4. Check status:

   Use the get_config_status tool
   

Remote Config Format

Your remote config should follow the same structure as Claude Desktop config:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Security

• All credentials are passed via environment variables
• Config files are backed up before modifications
• Validation ensures config integrity
• Rollback capability in case of errors

Development

# Clone the repository
git clone https://github.com/example/claude-config-sync.git
cd claude-config-sync

# Install dependencies
pip install -e .

# Run the server
python -m claude_config_sync

License

MIT License