Downloads Warden MCP

MCP运维云端

提供方 Rivka445

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

Downloads Warden是一款基于Model Context Protocol(MCP)的服务,通过AI智能管理下载文件夹,提供文件分类、去重、清理等功能。

一句话选型结论

按资料字段整理

Downloads Warden MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件管理Python本地部署AI自动化下载整理MCP服务本地处理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Downloads Warden MCP当前 7 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Rivka445上游标注的维护方 Rivka445
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.5 KB
来自项目仓库与上游目录的原文,未做删改

📥 git 初始化

使用FastMCP和Python 3.10+进行智能下载文件夹管理的专业MCP服务器。

🎯 概述

Downloads Warden是一个模型上下文协议(MCP)服务器,它将您的下载文件夹从混乱状态转换为有组织、高效的系统。通过MCP连接到Claude,AI代理可以通过智能操作自动管理您的文件。

✨ 特性

7强大的工具

工具 描述 类型
scan_下载 分析文件夹结构和统计信息 只读
smart_sport_files 将文件组织到智能类别中 写入
重复数据删除_by_hash 查找并删除完全重复项 写入
重复数据删除文件夹 查找并删除重复文件夹 写入
自动提取和清理 自动提取ZIP文件 写入
clear_installers 删除旧安装文件 写入
find_large_files 识别占用空间的文件 只读

智能组织

自动将文件分类:

  • 📄 文件 -PDF、DOCX、TXT、XLSX、PPTX
  • 🎬 媒体 -JPG、PNG、MP4、MP3、GIF
  • 🔧 安装程序 -EXE、MSI、DMG、PKG
  • 💻 代码 -PY、JS、TS、HTML、CSS、JSON
  • 📦 档案 -ZIP、RAR、7Z、TAR、GZ
  • 📂 其他 -其他文件

📋 先决条件

  • Python 3.10或更高版本
  • pip(Python包安装程序)
  • 支持MCP的Claude桌面

🚀 安装和设置

1.克隆/创建项目```bash

Navigate to your projects directory

cd ~/projects

Create project directory

mkdir downloads-warden
cd downloads-warden


### 2.安装依赖项````bash
# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

## 🚀 Quick Start

### Prerequisites

- Python 3.10 or higher
- pip or uv package manager
- Claude Desktop (for testing)

### Installation

```bash
# Clone or navigate to project
cd downloads-warden

# Create virtual environment
python -m venv venv
venv\Scripts\activate  # Windows
# or
source venv/bin/activate  # macOS/Linux

# Install dependencies
pip install -r requirements.txt````

### 运行服务器

```bash
# Direct run
python src/server.py

# Or with uv (if installed)
uv run src/server.py```

## 🧪 测试

### 单元测试

```bash
# Install test dependencies
pip install pytest pytest-asyncio

# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=src```

**测试结果:** ✅ 13/13项测试通过

### 与MCP检查员一起

```bash
mcp-inspector python src/server.py```

打开http://localhost:3000用于交互式工具测试。

## 💡 使用示例

配置后,您可以自然地与Claude聊天:

**示例1:全面分析**

> “克劳德,分析我的下载文件夹 告诉我如何节省空间”

克劳德将:

1. 跑 `scan_downloads` 获取统计数据
1. 跑 `deduplicate_by_hash` 查找重复项
1. 跑 `find_large_files` 识别太空猪
1. 提供建议

**示例2:快速清理**

> “清理我的资料夹,画画,拿出剪刀,删除重复”

克劳德将:

1. 跑 `smart_sort_files`
1. 跑 `auto_extract_and_cleanup`
1. 跑 `deduplicate_by_hash`
1. 跑 `deduplicate_folders`
1. 汇报进展

**示例3:空间管理**

> “我能节省多少空间?”

克劳德将:

1. 跑 `find_large_files`
1. 跑 `deduplicate_by_hash`
1. 跑 `clear_installers`
1. 计算潜在的节省

## 🏗 项目结构

downloads-warden/
├── src/
│ └── server.py # Main MCP server implementation
├── .vscode/
│ └── mcp.json # MCP server configuration
├── pyproject.toml # Project metadata
├── requirements.txt # Python dependencies
└── README.md # This file```

🔧 发展

以开发模式运行

# With virtual environment activated
python src/server.py```

### 本地测试工具

```python
# Example Python script to test a tool
import asyncio
from src.server import handle_scan_downloads

async def test():
result = await handle_scan_downloads(os.path.expanduser("~/Downloads"))
print(result)

asyncio.run(test())```

## 📝 API 参考

### 工具:scan_downloads

- **输入:** 无
- **输出:** 包含文件统计信息的报告
- **副作用:** 无(只读)

### 工具:smart_sport_files

- **输入:** 无
- **输出:** 移动文件摘要
- **副作用:** 修改文件夹结构

### 工具:重复数据删除_by_hash

- **输入:** 无
- **输出:** 已删除的重复项数量
- **副作用:** 删除文件

### 工具:重复数据删除文件夹

- **输入:** 无
- **输出:** 已删除的重复文件夹数
- **副作用:** 删除重复目录
- **说明:** 识别内容相同的文件夹,并在保留原始内容的同时删除重复项

### 工具:自动提取和清理

- **输入:** 无
- **输出:** 提取的文件数
- **副作用:** 创建目录,删除存档

### 工具:clear_installers

- **输入:** 无
- **输出:** 已删除的安装程序数量
- **副作用:** 删除旧的安装程序文件

### 工具:find_large_files

- **输入:** `min_size_mb` (数字,默认值:500)
- **输出:** 大文件列表
- **副作用:** 无(只读)

## ⚠️ 重要说明

- **备份:** 在使用清理工具之前,始终备份重要文件
- **权限:** 需要对下载文件夹进行读/写访问
- **隐私:** 所有操作都在您的计算机上本地运行
- **安全:** 删除前会验证重复文件
- **测试:** 首先对非关键文件进行测试

## 🔐 隐私和安全

- 没有数据发送到外部服务器
- 所有操作都在您的机器上本地进行
- 只有在验证后才会删除文件
- 基于哈希的重复数据删除可确保准确性

## 🐛 故障排除

### 服务器未启动

```bash
# Check Python version
python --version  # Should be 3.10+

# Verify MCP is installed
pip list | grep mcp

# Try running directly
python src/server.py

克劳德没有看到工具

  • 重新启动克劳德桌面
  • 检查claude_desktop_config.json语法
  • 验证配置中的文件路径是否正确
  • 检查虚拟环境是否处于活动状态

权限被拒绝错误

  • 以适当的权限运行
  • 检查文件/文件夹所有权
  • 在Windows上,可能需要管理员权限

📚 参考文献

  • 模型上下文协议文档
  • Python路径库文档
  • Python中的异步/等待

📄 许可证

MIT许可证-可根据您的需求自由使用和修改

🤝 贡献

欢迎投稿!请随时提交拉取请求或未决问题。


制作❤️ 用于随处可见的有序下载文件夹
```

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Downloads Warden MCP 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Downloads Warden MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Downloads Warden MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Downloads Warden MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Downloads Warden MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Downloads Warden MCP 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 本地处理、Python、Claude、AI自动化。具体工具清单以官方文档为准。

Downloads Warden MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Downloads Warden MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。