本地文件整理器

一个基于 Python 的文件组织系统，利用模型上下文协议（MCP）安全地在目录之间管理和组织文件。

概述

该项目实现了一个使用 MCP 框架的文件组织系统，以：

1. 安全访问用户指定的目录，通过强大的权限检查
2. 自动将文件按类型分类到分门别类的目录中
3. 在允许的目录中搜索文件
4. 分析目录内容并提供详细的文件信息

核心功能

• 目录安全：仅操作于显式允许的目录
• 智能分类：根据扩展名将文件整理为以下类别：
  • 文档（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 文件后：

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

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 以了解详细信息。