MCP Server Updater

一个 PowerShell 工具，用于分析和更新 Claude Desktop 的模型上下文协议 (MCP) 服务器。

🌟 功能

• 自动 MCP 服务器检测: 读取您的 Claude Desktop 配置以查找所有已配置的 MCP 服务器。
• 智能仓库分析: 即使 Git 仓库位于父目录中，也能检测到它们。
• 多技术支持: 处理各种项目类型，包括 Node.js、Python、Go、Java、Rust、.NET 和 C/C++。
• 详细报告: 提供对所有 MCP 服务器的全面分析。
• 自动更新检查: 识别具有可用更新的服务器。
• 用户确认更新: 在应用更新之前提示确认。
• 安全更新: 在应用更新之前创建备份分支（如果存在本地更改）。
• 智能构建过程: 在更新后，根据项目类型自动运行正确的构建命令。
• 标准化本地化: 使用 PowerShell 的标准本地化系统（.psd1 文件），易于扩展。

📋 要求

• Windows 10/11
• PowerShell 5.1 或更高版本
• Git 已安装并在您的 PATH 中
• Claude Desktop 已安装
• MCP 服务器的包管理器（npm、pip 等）

🚀 快速开始

1. 下载最新版本或克隆此仓库：

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

2. 从 PowerShell 运行脚本：

   # 允许脚本执行（如果需要，以管理员身份运行 PowerShell）
   # Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 
   
   # 运行更新程序
   .\Update-MCP-Servers.ps1 
   

   该脚本将分析您的服务器，报告状态，并询问您是否要更新任何具有待处理更改的服务器。

3. 要使用特定语言（例如，法语）：

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

   (有关更多详细信息，请参阅本地化部分)

📊 它做什么

该工具按顺序执行以下操作：

1. 分析阶段:

   • 读取 Claude Desktop 配置文件 (%APPDATA%\Claude\claude_desktop_config.json) 以识别所有 MCP 服务器。
   • 检测每个服务器在磁盘上的位置。
   • 查找与每个服务器关联的 Git 仓库（如果需要，搜索父目录）。
   • 确定项目类型和所需的构建工具。
   • 检查远程仓库是否有可用更新 (git fetch + git rev-list)。

2. 报告阶段:

   • 显示每个服务器的详细信息和更新状态。
   • 生成详细的 JSON 报告 (mcp-detailed-analysis.json)。
   • 生成操作日志 (mcp-updater-log.txt)。

3. 更新确认阶段:

   • 如果任何服务器有可用更新，它会列出它们。
   • 在继续更新之前，提示用户确认 (Y/N)。

4. 更新阶段（如果用户确认）：

   • 对于每个确认更新的服务器：
     • 使用 git stash 备份未提交的本地更改（可选，如果存在更改）。
     • 从远程仓库拉取最新更改 (git pull)。
     • 使用适当的包管理器安装依赖项（npm、pip 等）。
     • 使用正确的构建系统构建更新后的代码（npm run build、mvn install 等）。
   • 报告每个更新的成功或失败。

🛠️ 支持的项目类型

类型	检测方法	更新命令
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

🔧 配置

脚本本身不需要特殊配置。 它会自动从以下位置读取您的 Claude Desktop 配置：

%APPDATA%\Claude\claude_desktop_config.json

确保此文件正确列出了您的 MCP 服务器。

🌐 本地化

该工具使用 PowerShell 的标准本地化机制。面向用户的字符串存储在 Strings 文件夹下特定于语言的子目录中的 .psd1 文件中（例如，Strings\en-US、Strings\fr-FR）。

• 支持的语言：

  • 英语 (en-US) - 默认
  • 法语 (fr-FR)

• 语言选择：

  1. 参数： 使用带有支持的区域性代码的 -Language 参数（例如，.\Update-MCP-Servers.ps1 -Language fr-FR）。
  2. 系统默认： 如果未提供 -Language，则脚本尝试使用您系统的当前 UI 区域性 ($PSUICulture.Name)。
  3. 回退： 如果指定的语言和系统区域性都没有相应的 .psd1 文件，则回退到 en-US。

• 添加新语言：

  1. 在 Strings 中使用适当的区域性代码创建一个新子目录（例如，es-ES 代表西班牙语）。
  2. 将 Strings\en-US\Update-MCP-Servers.psd1 复制到您的新目录中。
  3. 翻译复制的 .psd1 文件中的字符串值。
  4. 您现在可以通过 -Language 参数使用新语言（例如，-Language es-ES）。

🔍 高级用法

命令行参数

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

• -Language <cultureCode>：设置显示语言。 使用标准区域性代码，如 en-US、fr-FR 等。

(注意：-Update 和 -ForceUpdate 参数已被删除。脚本现在自动检查更新并提示确认。)

环境变量

• MCP_UPDATER_BACKUP_DIR：（当前未实现）备份的自定义位置。
• MCP_UPDATER_LOG_LEVEL：（当前未实现）设置为 DEBUG 以进行更详细的日志记录。

🚀 主要改进

与基本更新方法相比，此工具提供：

1. 智能 Git 仓库检测 - 搜索父目录。
2. 增强的用户界面 - 清晰的显示与颜色编码。
3. 标准化本地化 - 使用 .psd1 文件易于扩展。
4. 简化执行 - 基本操作不需要复杂的参数。
5. 深度项目分析 - 自动检测项目类型和构建命令。
6. 本地更改保护 - 在更新之前隐藏本地更改。
7. 跨平台兼容性 - 适用于各种类型的 MCP 服务器。

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🤝 贡献

欢迎贡献！ 请随时提交 Pull Request。 考虑为新语言添加翻译！

☕ 支持开发

如果您觉得此模块有用，请考虑请我喝杯咖啡以支持进一步开发！

非常感谢您的支持，它有助于保持此项目的维护和改进！

📣 致谢

该工具是在 Anthropic 的 AI 助手 Claude 的帮助下创建的。

📝 其他语言

• README in French