MCP Server Updater

A PowerShell tool to analyze and update Model Context Protocol (MCP) servers for Claude Desktop.

🌟 Features

- Automatic MCP Server Detection: Reads your Claude Desktop configuration to find all configured MCP servers.
- Smart Repository Analysis: Detects Git repositories even if they're in parent directories.
- Multi-Technology Support: Handles various project types including Node.js, Python, Go, Java, Rust, .NET, and C/C++.
- Detailed Reporting: Provides comprehensive analysis of all your MCP servers.
- Automatic Update Check: Identifies servers with available updates.
- User-Confirmed Updates: Prompts for confirmation before applying updates.
- Safe Updates: Creates backup branches before applying updates (if local changes exist).
- Intelligent Build Process: Automatically runs the correct build commands based on project type after updating.
- Standardized Localization: Uses PowerShell's standard localization system (.psd1 files), easily extensible.

📋 Requirements

- Windows 10/11
- PowerShell 5.1 or later
- Git installed and in your PATH
- Claude Desktop installed
- Package managers for your MCP servers (npm, pip, etc.)

🚀 Quick Start

1. Download the latest release or clone this repository:

    git clone https://github.com/JayceeB1/mcp-server-updater.git

    cd mcp-server-updater

    

2. Run the script from PowerShell:

    # Allow script execution (if needed, run PowerShell as Admin)

    # Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 

    

    # Run the updater

    .\Update-MCP-Servers.ps1 

    

3. To use a specific language (e.g., French):

    .\Update-MCP-Servers.ps1 -Language fr-FR 

    

📊 What It Does

The tool performs these operations sequentially:

1. Analysis Phase:
- Reads the Claude Desktop configuration file (%APPDATA%\Claude\claude_desktop_config.json) to identify all MCP servers.
- Detects the location of each server on disk.
- Finds the Git repository associated with each server (searching parent directories if needed).
- Determines the project type and required build tools.
- Checks if updates are available from the remote repository (git fetch + git rev-list).

2. Reporting Phase:
- Displays detailed information and the update status for each server.
- Generates a detailed JSON report (mcp-detailed-analysis.json).
- Generates an operations log (mcp-updater-log.txt).

3. Update Confirmation Phase:
- If any servers have updates available, it lists them.
- Prompts the user for confirmation (Y/N) before proceeding with updates.

4. Update Phase (if confirmed by the user):
- For each server confirmed for update:
- Backs up uncommitted local changes using git stash (optional, if changes exist).
- Pulls the latest changes from the remote repository (git pull).
- Installs dependencies using the appropriate package manager (npm, pip, etc.).
- Builds the updated code using the correct build system (npm run build, mvn install, etc.).
- Reports the success or failure of each update.

🛠️ Supported Project Types

| Type | Detection Method | Update Commands |
| :--------- | :-------------------------------- | :---------------------------------- |
| Node.js | package.json | npm install, npm run build |
| TypeScript | tsconfig.json | npm install, npm run build |
| Python | requirements.txt, Pipfile, setup.py | pip install, pipenv install |
| Go | go.mod | go mod download, go build |
| Java | pom.xml, gradlew | mvn clean install, ./gradlew build |
| Rust | Cargo.toml | cargo build |
| .NET | .csproj | dotnet restore, dotnet build |
| C/C++ | Makefile, CMakeLists.txt | make, cmake |

%APPDATA%\Claude\claude_desktop_config.json

.\Update-MCP-Servers.ps1 [-Language <cultureCode>]

(Note: -Update and -ForceUpdate arguments have been removed. The script now automatically checks for updates and prompts for confirmation.)*

Environment Variables

- MCP_UPDATER_BACKUP_DIR: (Not currently implemented) Custom location for backups.
- MCP_UPDATER_LOG_LEVEL: (Not currently implemented) Set to DEBUG for more verbose logging.

🚀 Main Improvements

Compared to basic update methods, this tool provides:

1. Intelligent Git Repository Detection - Searches parent directories.
2. Enhanced User Interface - Clear display with color coding.
3. Standardized Localization - Easily extensible using .psd1 files.
4. Simplified Execution - No complex arguments needed for basic operation.
5. Deep Project Analysis - Automatic detection of project type and build commands.
6. Local Changes Protection - Stashes local changes before updating.
7. Cross-platform Compatibility - Works with various types of MCP servers.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Consider adding translations for new languages!

☕ Support Development

If you find this module useful, consider buying me a coffee to support further development!

Your support is greatly appreciated and helps keep this project maintained and improved!

📣 Acknowledgements

This tool was created with the help of Claude, an AI assistant from Anthropic.

📝 Other Languages

- README in French