Skip to main content
Glama
kk520879
by kk520879

🗑️ Undoom Uninstaller MCP

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

PyPI version Python 3.10+ License: MIT

✨ 功能特性

  • 📋 程序列表管理: 从Windows注册表获取已安装程序列表

  • 🔍 智能搜索: 支持按名称和发布商搜索程序

  • 📊 详细信息: 查看程序的详细信息(版本、大小、安装位置等)

  • 🗑️ 标准卸载: 使用程序自带的卸载程序进行卸载

  • 强制删除: 强制删除程序文件和注册表项

  • 🧹 残留清理: 清理程序卸载后的残留文件和文件夹

  • 🔄 列表刷新: 重新扫描系统中的已安装程序

  • 📈 美化报告: 生成详细的Markdown格式程序报告

Related MCP server: Smooth Operator Agent Tools

🚀 快速开始

安装方式

方式一:通过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" } }
  1. 查看程序详情

{ "tool": "get_program_details", "arguments": { "program_name": "Google Chrome" } }
  1. 生成美化报告

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

高级管理操作

  1. 卸载程序

{ "tool": "uninstall_program", "arguments": { "program_name": "Unwanted Software" } }
  1. 强制删除程序

{ "tool": "force_remove_program", "arguments": { "program_name": "Broken Software" } }
  1. 清理残留文件

{ "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 提供的优秀协议框架

  • 感谢所有贡献者和用户的支持


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

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kk520879/undoom_Uninstaller_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server