Local File Organizer
2025.03.21
0
Python文件管理文件管理
Local File Organizer 是一个基于 Python 的文件管理系统，利用 Model Context Protocol (MCP) 安全地组织和跨目录管理文件。它通过权限检查、自动文件分类、目录内容分析和文件搜索等功能，帮助用户高效管理本地文件。
View on GitHub
Overview
基本能力
产品定位
Local File Organizer 是一个基于 Python 的文件管理系统，利用 Model Context Protocol (MCP) 安全地组织和跨目录管理文件。
核心功能
- 目录安全：仅操作明确允许的目录
- 智能分类：按扩展名将文件分类到不同类别（文档、图片、视频、音频、存档、代码、应用程序等）
- 项目检测：识别项目目录以避免干扰代码仓库
- 递归处理：分析和组织嵌套目录结构
- 资源高效：针对大型目录结构优化性能
- 详细分析：提供按类型分布的文件洞察
适用场景
- 自动整理杂乱的文件目录
- 快速查找特定类型的文件
- 分析目录内容以了解文件分布
- 安全地管理多个目录中的文件
工具列表
list_categories：列出所有可用类别analyze_directory：分析目录而不做更改create_category_directories：在目标目录中创建类别文件夹organize_files：按类型组织文件search_files：搜索文件
常见问题解答
- 如何配置允许的目录？通过修改
.cursor/mcp.json文件 - 如何启用 MCP 服务器？在 Cursor 设置中导航到
MCP并启用filesystem服务器
使用教程
使用依赖
# Clone the repository
git clone https://github.com/diganto-deb/local_file_organizer.git
cd local_file_organizer
# Install requirements
pip install -r requirements.txt
安装教程
- 克隆仓库并安装依赖（如上所示）
- 配置
.cursor/mcp.json文件以指定允许的目录 - 在 Cursor IDE 中启用 MCP 服务器
调试方式
# 列出所有可用类别
list_categories
# 分析目录而不做更改
analyze_directory /path/to/directory
# 在目标目录中创建类别文件夹
create_category_directories /path/to/target
# 按类型组织文件
organize_files /path/to/directory
# 搜索文件
search_files /path/to/directory "*.jpg"