README.md•9.07 kB
# 🗑️ Undoom Uninstaller MCP
一个基于MCP (Model Context Protocol) 的Windows程序卸载器服务，提供程序管理、卸载、强制删除和残留清理功能。
[](https://badge.fury.io/py/undoom-uninstaller-mcp)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
## ✨ 功能特性
- 📋 **程序列表管理**: 从Windows注册表获取已安装程序列表
- 🔍 **智能搜索**: 支持按名称和发布商搜索程序
- 📊 **详细信息**: 查看程序的详细信息（版本、大小、安装位置等）
- 🗑️ **标准卸载**: 使用程序自带的卸载程序进行卸载
- ⚡ **强制删除**: 强制删除程序文件和注册表项
- 🧹 **残留清理**: 清理程序卸载后的残留文件和文件夹
- 🔄 **列表刷新**: 重新扫描系统中的已安装程序
- 📈 **美化报告**: 生成详细的Markdown格式程序报告
## 🚀 快速开始
### 安装方式
#### 方式一：通过PyPI安装（推荐）
```bash
# 使用uv安装
uvx --index-url https://pypi.tuna.tsinghua.edu.cn/simple undoom-uninstaller-mcp
# 或使用pip安装
pip install undoom-uninstaller-mcp
```
#### 方式二：从源码安装
```bash
git clone https://github.com/kk520879/undoom_Uninstaller_mcp.git
cd undoom_Uninstaller_mcp
uv sync
```
### MCP配置
在您的MCP客户端配置文件中添加以下配置：
```json
{
"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` (可选): 搜索关键词
**返回信息:**
- 程序名称、发布商、版本、大小、安装位置
- **新增**: 安装时间、所在盘符
**示例:**
```json
{
"search": "chrome"
}
```
#### 2. get_program_details
获取指定程序的详细信息（包含安装时间和盘符信息）
**参数:**
- `program_name` (必需): 程序名称
**返回信息:**
- 程序名称、发布商、版本、大小、安装位置、卸载字符串、注册表键
- **新增**: 安装时间、所在盘符
**示例:**
```json
{
"program_name": "Google Chrome"
}
```
#### 3. uninstall_program
卸载指定程序（使用程序自带的卸载程序）
**参数:**
- `program_name` (必需): 要卸载的程序名称
**示例:**
```json
{
"program_name": "Google Chrome"
}
```
#### 4. force_remove_program
强制删除程序（删除文件和注册表项）
**警告**: 此操作不可逆，请谨慎使用
**参数:**
- `program_name` (必需): 要强制删除的程序名称
**示例:**
```json
{
"program_name": "Broken Software"
}
```
#### 5. clean_residues
清理程序残留文件
**参数:**
- `program_name` (必需): 要清理残留的程序名称
**示例:**
```json
{
"program_name": "Old Program"
}
```
#### 6. refresh_programs
刷新程序列表
**参数:** 无
#### 7. show_all_programs_detailed
显示所有程序的详细信息，包括名称、安装时间和盘符
**参数:**
- `limit` (可选): 限制返回的程序数量，默认为100
- `sort_by` (可选): 排序字段，可选值：
- `name`: 按程序名称排序（默认）
- `install_date`: 按安装时间排序
- `drive_letter`: 按盘符排序
**返回信息:**
- 程序名称、安装时间、所在盘符
- 发布商、版本、大小、安装位置
**示例:**
```json
{
"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报告文件
- 包含统计概览、分类显示、程序详细列表等
- 支持按类别分组显示（开发工具、浏览器、游戏等）
**示例:**
```json
{
"filename": "my_programs_report",
"limit": 100,
"sort_by": "name",
"include_stats": true
}
```
## 🎯 使用示例
### 基本操作示例
1. **获取程序列表**
```json
// 获取所有程序
{
"tool": "list_programs"
}
// 搜索特定程序
{
"tool": "list_programs",
"arguments": {
"search": "chrome"
}
}
```
2. **查看程序详情**
```json
{
"tool": "get_program_details",
"arguments": {
"program_name": "Google Chrome"
}
}
```
3. **生成美化报告**
```json
{
"tool": "generate_markdown_report",
"arguments": {
"filename": "system_analysis",
"limit": 50,
"sort_by": "install_date",
"include_stats": true
}
}
```
### 高级管理操作
4. **卸载程序**
```json
{
"tool": "uninstall_program",
"arguments": {
"program_name": "Unwanted Software"
}
}
```
5. **强制删除程序**
```json
{
"tool": "force_remove_program",
"arguments": {
"program_name": "Broken Software"
}
}
```
6. **清理残留文件**
```json
{
"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](https://github.com/kk520879/undoom_Uninstaller_mcp/issues) 页面提交。
## 📄 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 🙏 致谢
- 感谢 [MCP](https://modelcontextprotocol.io/) 提供的优秀协议框架
- 感谢所有贡献者和用户的支持
---
<div align="center">
**如果这个项目对您有帮助，请给它一个 ⭐**
[报告问题](https://github.com/kk520879/undoom_Uninstaller_mcp/issues) • [功能请求](https://github.com/kk520879/undoom_Uninstaller_mcp/issues) • [贡献代码](https://github.com/kk520879/undoom_Uninstaller_mcp/pulls)
</div>