Generates detailed Markdown reports containing system program information, statistics, and categorized program listings
Distributed as a Python package through PyPI for easy installation and deployment of the Windows program management functionality
Provides tools for managing Windows programs through Python-based registry scanning and program manipulation capabilities
🗑️ Undoom Uninstaller MCP
一个基于MCP (Model Context Protocol) 的Windows程序卸载器服务,提供程序管理、卸载、强制删除和残留清理功能。
✨ 功能特性
📋 程序列表管理: 从Windows注册表获取已安装程序列表
🔍 智能搜索: 支持按名称和发布商搜索程序
📊 详细信息: 查看程序的详细信息(版本、大小、安装位置等)
🗑️ 标准卸载: 使用程序自带的卸载程序进行卸载
⚡ 强制删除: 强制删除程序文件和注册表项
🧹 残留清理: 清理程序卸载后的残留文件和文件夹
🔄 列表刷新: 重新扫描系统中的已安装程序
📈 美化报告: 生成详细的Markdown格式程序报告
Related MCP server: Smooth Operator Agent Tools
🚀 快速开始
安装方式
方式一:通过PyPI安装(推荐)
方式二:从源码安装
MCP配置
在您的MCP客户端配置文件中添加以下配置:
常见MCP客户端配置位置:
Claude Desktop:
%APPDATA%\Claude\claude_desktop_config.jsonCodeBuddy: 在设置中的MCP服务器配置
其他客户端: 请参考相应客户端的文档
📖 使用方法
启动MCP服务器
配置完成后,MCP服务器会自动启动。您可以通过MCP客户端调用以下工具:
🛠️ 可用工具
以下是所有可用的MCP工具及其详细说明:
1. list_programs
列出所有已安装的程序(包含安装时间和盘符信息)
参数:
search(可选): 搜索关键词
返回信息:
程序名称、发布商、版本、大小、安装位置
新增: 安装时间、所在盘符
示例:
2. get_program_details
获取指定程序的详细信息(包含安装时间和盘符信息)
参数:
program_name(必需): 程序名称
返回信息:
程序名称、发布商、版本、大小、安装位置、卸载字符串、注册表键
新增: 安装时间、所在盘符
示例:
3. uninstall_program
卸载指定程序(使用程序自带的卸载程序)
参数:
program_name(必需): 要卸载的程序名称
示例:
4. force_remove_program
强制删除程序(删除文件和注册表项)
警告: 此操作不可逆,请谨慎使用
参数:
program_name(必需): 要强制删除的程序名称
示例:
5. clean_residues
清理程序残留文件
参数:
program_name(必需): 要清理残留的程序名称
示例:
6. refresh_programs
刷新程序列表
参数: 无
7. show_all_programs_detailed
显示所有程序的详细信息,包括名称、安装时间和盘符
参数:
limit(可选): 限制返回的程序数量,默认为100sort_by(可选): 排序字段,可选值:name: 按程序名称排序(默认)install_date: 按安装时间排序drive_letter: 按盘符排序
返回信息:
程序名称、安装时间、所在盘符
发布商、版本、大小、安装位置
示例:
8. generate_markdown_report
生成系统程序信息的美化Markdown报告文件
参数:
filename(可选): 输出文件名(不包含扩展名),默认为'system_programs_report'limit(可选): 限制返回的程序数量,默认为200sort_by(可选): 排序字段,可选值:name: 按程序名称排序(默认)install_date: 按安装时间排序drive_letter: 按盘符排序
include_stats(可选): 是否包含详细统计信息,默认为true
返回信息:
生成包含所有程序信息的美化Markdown报告文件
包含统计概览、分类显示、程序详细列表等
支持按类别分组显示(开发工具、浏览器、游戏等)
示例:
🎯 使用示例
基本操作示例
获取程序列表
查看程序详情
生成美化报告
高级管理操作
卸载程序
强制删除程序
清理残留文件
🔧 技术实现
数据来源
程序信息从以下Windows注册表位置获取:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\UninstallHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\UninstallHKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
程序信息字段
字段 | 描述 | 示例 |
name | 程序名称 |
|
publisher | 发布商 |
|
version | 版本号 |
|
size | 安装大小 |
|
install_location | 安装位置 |
|
install_date | 安装时间 |
|
drive_letter | 所在盘符 |
,
,
|
uninstall_string | 卸载命令 | 程序的卸载命令行 |
reg_key | 注册表键路径 | 注册表中的完整路径 |
残留清理位置
系统会自动检查以下常见残留位置:
📁 程序安装目录
📁
%APPDATA%\[程序名]📁
%LOCALAPPDATA%\[程序名]📁
%PROGRAMDATA%\[程序名]📁
%USERPROFILE%\AppData\Local\[程序名]📁
%USERPROFILE%\AppData\Roaming\[程序名]
美化报告特性
📊 智能分类: 自动将程序按类型分组(开发工具、浏览器、游戏等)
📈 可视化统计: 盘符分布图表、发布商统计等
🎨 美观界面: 使用图标和颜色增强可读性
📋 详细信息: 包含完整的程序信息和系统统计
⚠️ 注意事项
⚠️ 重要提醒 | 说明 |
管理员权限 | 某些操作可能需要管理员权限才能执行 |
数据安全 | 强制删除和残留清理操作不可逆,请谨慎使用 |
系统兼容性 | 仅支持Windows系统(Windows 10/11推荐) |
程序限制 | 某些系统程序可能无法卸载或删除 |
备份建议 | 执行删除操作前建议备份重要数据 |
🤝 贡献指南
我们欢迎各种形式的贡献!
如何贡献
Fork 本项目
创建您的特性分支 (
git checkout -b feature/AmazingFeature)提交您的更改 (
git commit -m 'Add some AmazingFeature')推送到分支 (
git push origin feature/AmazingFeature)打开一个 Pull Request
报告问题
如果您发现了bug或有功能建议,请在 Issues 页面提交。
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🙏 致谢
感谢 MCP 提供的优秀协议框架
感谢所有贡献者和用户的支持
如果这个项目对您有帮助,请给它一个 ⭐