🚀 本地文件整理器
这是一个基于 Python 的文件组织系统，借助模型上下文协议（MCP），能安全地在不同目录间管理和组织文件，有效提升文件管理效率。
🚀 快速开始
本项目实现了一个运用 MCP 框架的文件组织系统，具备以下能力：
- 借助强大的权限检查，安全访问用户指定的目录。
- 自动依据文件类型，将文件分类到对应的目录中。
- 在允许访问的目录里搜索文件。
- 分析目录内容，并提供详细的文件信息。
✨ 主要特性
- 目录安全：仅对显式允许的目录进行操作，保障文件安全。
- 智能分类：依据文件扩展名，将文件整理为以下类别：
- 文档（PDF、DOC、DOCX、TXT、RTF、MD、HTML、JSON、CSV 等）
- 图像（JPG、PNG、GIF、SVG、WEBP、HEIC 等）
- 视频（MP4、MOV、AVI、MKV 等）
- 音频（MP3、WAV、OGG、FLAC 等）
- 归档（ZIP、RAR、7Z、TAR 等）
- 代码（PY、JS、HTML、CSS、Java 等）
- 应用程序（DMG、EXE、MSI 等）
- 其他（未分类的文件类型）
- 项目检测：能够识别代码仓库，避免对其造成干扰。
- 递归处理：可分析和整理嵌套的目录结构。
- 资源高效：针对大型目录结构进行了性能优化，节省系统资源。
- 详细分析：提供按文件类型分布的洞察信息。
📦 安装指南
# 克隆仓库
git clone https://github.com/diganto-deb/local_file_organizer.git
cd local_file_organizer
# 安装依赖项
pip install -r requirements.txt
💻 使用示例
基础用法
1. 配置允许目录
创建或修改项目目录中的 .cursor/mcp.json 文件：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/organize/dir1",
"/path/to/organize/dir2"
]
}
}
}
将路径替换为您要允许 MCP 服务器访问的目录。
2. 启用 MCP 服务器
在配置 .cursor/mcp.json 文件后：
- 重启 Cursor。
- 打开 Cursor 设置（⚙️）。
- 进入
MCP。 - 您应该会在 MCP 服务器列表中看到
filesystem服务器，服务器应显示名称为 "filesystem"。 - 点击旁边服务器名称的切换开关以启用它。
3. 使用文件组织命令
一旦启用了 MCP 服务器，您就可以直接在 Cursor 的代理中使用文件组织命令：
# 列出所有可用类别
list_categories
# 分析目录而不进行更改
analyze_directory /path/to/directory
# 在目标目录创建分类文件夹
create_category_directories /path/to/target
# 按类型整理文件
organize_files /path/to/directory
# 搜索文件
search_files /path/to/directory "*.jpg"
🔧 技术细节
该系统使用了以下技术：
- MCP Python SDK：用于核心服务器的实现。
- Filesystem MCP Server：用于文件系统的处理。
- Pathlib：用于路径操作。
- 类型注解：提升代码的可维护性和清晰度。
📚 详细文档
计划功能
未来版本将添加以下功能：
- 支持更多文件类型和分类。
- 提供图形用户界面（GUI）。
- 集成云存储支持。
- 增强的安全性和权限控制。
贡献
如需贡献，请访问项目仓库：https://github.com/diganto-deb/local_file_organizer
📄 许可证
该软件受 MIT 许可证的保护。请参阅 LICENSE 以了解详细信息。