文件管理与云备份系统

一个基于AI的智能文件管理系统,支持本地文件管理和Google Drive云备份,具备智能清理、自动组织和自然语言控制功能。

  • by NestorZuno
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 NestorZuno/mcp-file-manager

使用说明

📂 MCP文件管理器和云备份

人工智能增强的本地和云文件智能管理系统

该项目实现了一个服务器 MCP(模型上下文协议) 允许语言模型与本地文件系统交互并在谷歌驱动器上执行备份。


🚀 主要特征

🧹 智能清洁

使用检测重复文件 哈希MD5即使他们有不同的名字。

🗂️ 自动组织

按类型将文件分类为文件夹,如:图像、文档、代码、音频等。

☁️ 云备份

英特格拉 Google Drive API v3 自动或按需上传关键文件。

🛡️ 安全删除

使用 send2trash 以避免意外永久删除。

🤖 自然界面

允许使用自然语言进行控制:

“清理我的文件夹”,“将此文件上载到驱动器”,“组织我的文档”。


🛠️ 安装

1.克隆存储库

github.com/NestorZuno/mcp-file-manager

2.创建虚拟环境

python -m venv venv

视窗

.\venv\Scripts\activate

Mac/Linux

source venv/bin/activate

3.安装依赖项

pip install -r requirements.txt

☁️ 谷歌驱动器配置

放置您的文件 credentials.json 在项目的根。

然后执行授权过程:

python utils/drive_handler.py

⚙️ 与Cline/Claude桌面一起使用

{
  "mcpServers": {
    "file-manager": {
      "command": "RUTA_AL_PROYECTO/venv/Scripts/python.exe",
      "args": ["RUTA_AL_PROYECTO/server.py"]
    }
  }
}

🏗️ 项目结构

mcp-file-manager/
├── server.py                 # Servidor MCP y orquestador de herramientas
├── utils/
│   ├── duplicates.py         # Detección de duplicados (Hash MD5)
│   ├── drive_handler.py      # Autenticación OAuth 2.0 y subida a Google Drive
│   └── organizer.py          # Organización automática de archivos
├── requirements.txt
└── credentials.json          # (Proporcionado por el usuario)

📜 许可证

该项目已获得许可 麻省理工学院.
您可以在这里查看完整的文件:

➡️ 许可证


✍️ 作者

内斯托尔·祖诺·塞古拉
计算机工程