文件组织器

基于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：用于核心服务器实现。
• 文件系统MCP服务器：用于安全的文件操作。
• Pathlib：用于跨平台路径处理。
• 类型注解：用于提高代码质量和IDE支持。

计划功能

以下功能计划在未来版本中添加：

1. 文件写入和编辑功能：增加能力：
   • 直接修改文件内容。
   • 使用模板创建新文件。
   • 使用模式批量重命名文件。
   • 编辑文件元数据。

贡献

欢迎贡献！请随意提交Pull Request。

许可证

本项目采用MIT许可证——详情见LICENSE文件。

致谢

• 模型上下文协议（MCP）团队
• Cursor IDE用于MCP集成