📂 文件管理MCP服务器
用于Windows的本地MCP服务器，为LLM提供清理文件系统的工具。
主要功能
- 目录分析：查看文件/文件夹列表，提取日期信息
- 检查文件内容：读取文本/代码文件段（支持cp949/euc-kr编码）
- 图像元数据：从EXIF信息中提取拍摄日期
- 智能文件分析：通过文本分析和图像分析提供文件名（LLM联合）
- 文件分组：建议分析相关文件并自动分组
- 使用文件：移动、重命名、创建文件夹、清理未知文件名
- 批处理：批量添加日期前缀，移动多个文件组文件夹
- 安全功能：Dry Run模式，沙盒限制，系统文件夹保护
📋 文件清理规则
两个绝对规则
- 五步规则：目录深度最多可达到5级
- 编号系统：文件夹
00~99使用前缀（例如：01_Project),99用于归档
命名规则
- 文件夹:
NN_이름格式（例如：01_Business,02_Project) - 文件:
YYMMDD_파일명格式（例如：251202_회의록.docx) - 版本:
_v1.0格式（Final，最终禁止！）
🚀 安装和运行
要求
- Windows 10/11
- Python 3.13+
- 紫外线
安装uv dependenty
uv pip install -r requirements.txt配置Claude Desktop
Claude桌面设置（claude_desktop_config.json)
窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"file-organization-agent": {
"command": "uv",
"args": [
"--directory",
"{your_path}/FileManageMCP",
"run",
"python",
"server.py"
]
}
}
}🛠️ 可用工具
设置工具
| 工具 | 说明 |
|---|---|
tool_set_dry_run | 设置Dry Run模式（默认：启用） |
tool_get_status | 检查当前设置状态 |
tool_configure_workspace | 设置工作区（沙盒） |
分析工具（Read-Only）
| 工具 | 说明 |
|---|---|
tool_list_directory 查询目录内容（包括日期信息） | |
tool_read_file_snippet | 预览文件内容 |
tool_get_image_metadata | 提取图像EXIF信息 |
tool_analyze_directory_structure | 分析目录结构并确定问题 |
高级分析和清理工具
| 工具 | 说明 |
|---|---|
tool_find_files_needing_rename | 查找具有未知文件名的文件（挖掘清理对象） |
tool_suggest_filename_from_content | 返回文件内容（文本/文档）分析摘要 |
tool_get_image_for_analysis | 返回用于图像文件分析的数据（与LLM Vision集成） |
tool_analyze_file_relationships | 文件关系分析和分组建议 |
动作工具（支持Dry Run）
| 工具 | 说明 |
|---|---|
tool_move_file | 移动文件 |
tool_rename_file | 重命名文件/文件夹 |
tool_rename_with_suggestion | 更改为LLM建议名称（高级） |
tool_create_folder | 创建新文件夹 |
tool_group_files_into_folder | 将相关文件批量移动到新文件夹（高级） |
tool_batch_rename_with_date | 批量添加日期前缀 |
🔒 安全功能
Dry Run模式（默认启用）
- 默认情况下，所有文件修改操作都只进行模拟。
- 可以在实际更改前查看预期结果
tool_set_dry_run(false)通过调用切换实际模式
沙盒限制
tool_configure_workspace将工作区设置为- 阻止对设置区域的外部访问
保护系统文件夹
访问被阻止的路径：
C:\WindowsC:\Program FilesC:\Program Files (x86).git,node_modules等
📖 使用示例
默认工作流
User: D:\Downloads 폴더를 정리해줘
AI:
1. 먼저 작업 영역을 설정합니다.
→ tool_configure_workspace("D:\\Downloads")
2. 현재 상태를 확인합니다.
→ tool_get_status() # Dry Run 활성화 확인
3. 디렉토리 구조를 분석합니다.
→ tool_analyze_directory_structure("D:\\Downloads")
4. 의미를 알 수 없는 파일명 파일들을 찾아 정리합니다.
→ tool_find_files_needing_rename("D:\\Downloads")
→ tool_suggest_filename_from_content(...) 또는 tool_get_image_for_analysis(...)
→ tool_rename_with_suggestion(...)
5. 남은 파일들을 주제별로 그룹핑합니다.
→ tool_analyze_file_relationships("D:\\Downloads")
→ tool_group_files_into_folder("D:\\Downloads", "01_References", ["file1.txt", "file2.pdf"])
6. 결과 확인 후 실제 실행합니다.
→ tool_set_dry_run(false)
→ (위 작업 실제 수행)📁 项目结构
FileManageMCP/
├── server.py # MCP 서버 진입점 (FastMCP)
├── tools.py # MCP 도구 함수 구현
├── utils.py # 유틸리티 (경로 검증, 인코딩 처리)
├── requirements.txt # Python 의존성
└── README.md # 이 문서📸 运行示例
📜 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。