🚀 本地文件整理器

本地文件整理器是一个基于 Python 的文件组织系统，借助模型上下文协议（MCP），能够安全地在不同目录间管理和组织文件，有效提升文件管理效率。

🚀 快速开始

本地文件整理器是一个强大的文件组织系统，利用模型上下文协议（MCP）安全地管理和组织文件。以下是快速上手的步骤：

安装

# 克隆仓库
git clone https://github.com/diganto-deb/local_file_organizer.git
cd local_file_organizer

# 安装依赖项
pip install -r requirements.txt

配置允许目录

创建或修改项目目录中的 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/organize/dir1",
        "/path/to/organize/dir2"
      ]
    }
  }
}

将路径替换为您要允许 MCP 服务器访问的目录。

启用 MCP 服务器

在配置 .cursor/mcp.json 文件后：

1. 重启 Cursor。
2. 打开 Cursor 设置（⚙️）。
3. 进入 MCP。
4. 您应该会在 MCP 服务器列表中看到 filesystem 服务器，服务器应显示名称为 "filesystem"。
5. 点击旁边服务器名称的切换开关以启用它。

使用文件组织命令

一旦启用了 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"

✨ 主要特性

• 目录安全：仅操作于显式允许的目录，保障文件操作的安全性。
• 智能分类：根据扩展名将文件整理为以下类别：
  • 文档（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 等）
  • 其他（未分类的文件类型）
• 项目检测：识别代码仓库以避免干扰，确保项目文件不受影响。
• 递归处理：可以分析和整理嵌套目录结构，全面管理文件。
• 资源高效：针对大型目录结构进行了性能优化，提升处理效率。
• 详细分析：提供按类型分布的文件洞察，让您了解文件分布情况。

🔧 技术细节

该系统使用了以下技术实现：

• MCP Python SDK：用于核心服务器实现，确保系统的稳定性和可靠性。
• Filesystem MCP Server：用于文件系统的处理，高效管理文件操作。
• Pathlib：用于路径操作，简化路径处理流程。
• 类型注解：用于代码的可维护性和清晰度，方便后续开发和维护。

📚 详细文档

计划功能

未来版本将添加以下功能：

• 支持更多文件类型和分类，满足更多使用场景。
• 提供图形用户界面（GUI），提升用户操作体验。
• 集成云存储支持，方便文件的云端存储和管理。
• 增强的安全性和权限控制，进一步保障文件安全。

贡献

如需贡献，请访问项目仓库：https://github.com/diganto-deb/local_file_organizer

📄 许可证

该软件受 MIT 许可证的保护。请参阅 LICENSE 以了解详细信息。