🗑️ Undoom Uninstaller MCP

一个基于MCP (Model Context Protocol) 的Windows程序卸载器服务，提供程序管理、卸载、强制删除和残留清理功能。

✨ 功能特性

• 📋 程序列表管理: 从Windows注册表获取已安装程序列表
• 🔍 智能搜索: 支持按名称和发布商搜索程序
• 📊 详细信息: 查看程序的详细信息（版本、大小、安装位置等）
• 🗑️ 标准卸载: 使用程序自带的卸载程序进行卸载
• ⚡ 强制删除: 强制删除程序文件和注册表项
• 🧹 残留清理: 清理程序卸载后的残留文件和文件夹
• 🔄 列表刷新: 重新扫描系统中的已安装程序
• 📈 美化报告: 生成详细的Markdown格式程序报告

🚀 快速开始

安装方式

方式一：通过PyPI安装（推荐）

# 使用uv安装
uvx --index-url https://pypi.tuna.tsinghua.edu.cn/simple undoom-uninstaller-mcp

# 或使用pip安装
pip install undoom-uninstaller-mcp

方式二：从源码安装

git clone https://github.com/kk520879/undoom_Uninstaller_mcp.git
cd undoom_Uninstaller_mcp
uv sync

MCP配置

在您的MCP客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "undoom-uninstaller-mcp": {
      "command": "uvx",
      "args": [
        "--index-url",
        "https://pypi.tuna.tsinghua.edu.cn/simple",
        "undoom-uninstaller-mcp"
      ]
    }
  }
}

常见MCP客户端配置位置：

• Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json
• CodeBuddy: 在设置中的MCP服务器配置
• 其他客户端: 请参考相应客户端的文档

📖 使用方法

启动MCP服务器

配置完成后，MCP服务器会自动启动。您可以通过MCP客户端调用以下工具：

🛠️ 可用工具

以下是所有可用的MCP工具及其详细说明：

1. list_programs

列出所有已安装的程序（包含安装时间和盘符信息）

参数:

• search (可选): 搜索关键词

返回信息:

• 程序名称、发布商、版本、大小、安装位置
• 新增: 安装时间、所在盘符

示例:

{
  "search": "chrome"
}

2. get_program_details

获取指定程序的详细信息（包含安装时间和盘符信息）

参数:

• program_name (必需): 程序名称

返回信息:

• 程序名称、发布商、版本、大小、安装位置、卸载字符串、注册表键
• 新增: 安装时间、所在盘符

示例:

{
  "program_name": "Google Chrome"
}

3. uninstall_program

卸载指定程序（使用程序自带的卸载程序）

参数:

• program_name (必需): 要卸载的程序名称

示例:

{
  "program_name": "Google Chrome"
}

4. force_remove_program

强制删除程序（删除文件和注册表项）

警告: 此操作不可逆，请谨慎使用

参数:

• program_name (必需): 要强制删除的程序名称

示例:

{
  "program_name": "Broken Software"
}

5. clean_residues

清理程序残留文件

参数:

• program_name (必需): 要清理残留的程序名称

示例:

{
  "program_name": "Old Program"
}

6. refresh_programs

刷新程序列表

参数: 无

7. show_all_programs_detailed

显示所有程序的详细信息，包括名称、安装时间和盘符

参数:

• limit (可选): 限制返回的程序数量，默认为100
• sort_by (可选): 排序字段，可选值：
  • name: 按程序名称排序（默认）
  • install_date: 按安装时间排序
  • drive_letter: 按盘符排序

返回信息:

• 程序名称、安装时间、所在盘符
• 发布商、版本、大小、安装位置

示例:

{
  "limit": 50,
  "sort_by": "install_date"
}

8. generate_markdown_report

生成系统程序信息的美化Markdown报告文件

参数:

• filename (可选): 输出文件名（不包含扩展名），默认为'system_programs_report'
• limit (可选): 限制返回的程序数量，默认为200
• sort_by (可选): 排序字段，可选值：
  • name: 按程序名称排序（默认）
  • install_date: 按安装时间排序
  • drive_letter: 按盘符排序
• include_stats (可选): 是否包含详细统计信息，默认为true

返回信息:

• 生成包含所有程序信息的美化Markdown报告文件
• 包含统计概览、分类显示、程序详细列表等
• 支持按类别分组显示（开发工具、浏览器、游戏等）

示例:

{
  "filename": "my_programs_report",
  "limit": 100,
  "sort_by": "name",
  "include_stats": true
}

🎯 使用示例

基本操作示例

1. 获取程序列表

// 获取所有程序
{
  "tool": "list_programs"
}

// 搜索特定程序
{
  "tool": "list_programs",
  "arguments": {
    "search": "chrome"
  }
}

2. 查看程序详情

{
  "tool": "get_program_details",
  "arguments": {
    "program_name": "Google Chrome"
  }
}

3. 生成美化报告

{
  "tool": "generate_markdown_report",
  "arguments": {
    "filename": "system_analysis",
    "limit": 50,
    "sort_by": "install_date",
    "include_stats": true
  }
}

高级管理操作

4. 卸载程序

{
  "tool": "uninstall_program",
  "arguments": {
    "program_name": "Unwanted Software"
  }
}

5. 强制删除程序

{
  "tool": "force_remove_program",
  "arguments": {
    "program_name": "Broken Software"
  }
}

6. 清理残留文件

{
  "tool": "clean_residues",
  "arguments": {
    "program_name": "Old Program"
  }
}

🔧 技术实现

数据来源

程序信息从以下Windows注册表位置获取：

• HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
• HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall
• HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

程序信息字段

字段	描述	示例
name	程序名称	Google Chrome
publisher	发布商	Google LLC
version	版本号	139.0.7258.66
size	安装大小	342.3 MB
install_location	安装位置	C:\Program Files\Google\Chrome
install_date	安装时间	2025-08-07
drive_letter	所在盘符	C:, D:, 网络路径
uninstall_string	卸载命令	程序的卸载命令行
reg_key	注册表键路径	注册表中的完整路径

残留清理位置

系统会自动检查以下常见残留位置：

• 📁 程序安装目录
• 📁 %APPDATA%\[程序名]
• 📁 %LOCALAPPDATA%\[程序名]
• 📁 %PROGRAMDATA%\[程序名]
• 📁 %USERPROFILE%\AppData\Local\[程序名]
• 📁 %USERPROFILE%\AppData\Roaming\[程序名]

美化报告特性

• 📊 智能分类: 自动将程序按类型分组（开发工具、浏览器、游戏等）
• 📈 可视化统计: 盘符分布图表、发布商统计等
• 🎨 美观界面: 使用图标和颜色增强可读性
• 📋 详细信息: 包含完整的程序信息和系统统计

⚠️ 注意事项

⚠️ 重要提醒	说明
管理员权限	某些操作可能需要管理员权限才能执行
数据安全	强制删除和残留清理操作不可逆，请谨慎使用
系统兼容性	仅支持Windows系统（Windows 10/11推荐）
程序限制	某些系统程序可能无法卸载或删除
备份建议	执行删除操作前建议备份重要数据

🤝 贡献指南

我们欢迎各种形式的贡献！

如何贡献

1. Fork 本项目
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

报告问题

如果您发现了bug或有功能建议，请在 Issues 页面提交。

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 感谢 MCP 提供的优秀协议框架
• 感谢所有贡献者和用户的支持

---

<div align="center">

如果这个项目对您有帮助，请给它一个 ⭐

报告问题 • 功能请求 • 贡献代码

</div>