文件智能组织服务

一个MCP服务器,能够智能地组织文件,包括读取内容、检测重复文件、建议有意义的文件名以及将文件移动到逻辑文件夹中。

  • by le7-3609
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 le7-3609/organizer-mcp-server

使用说明

管理器MCP服务器

一个MCP服务器,使Claude能够智能地组织文件——读取内容、检测重复项、建议有意义的名称,并将文件移动到逻辑文件夹中。

🎬 演示

观看演示

工具

工具 说明
scan_folder 获取文件统计信息、类型并检测通用文件名
find_duplicates 按内容哈希查找相同的文件
create_junk_folder 将不需要的文件移动到隔离文件夹
read_file 读取文件内容以进行AI分析
suggest_filename 从文件内容中建议有意义的名称
rename_file 为文件应用新名称
organize_folder 将文件移动到AI创建的类别文件夹中

设置

1.安装依赖项

python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # macOS / Linux
pip install -r requirements.txt

2.添加到克劳德桌面

编辑您的Claude Desktop配置文件:

  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "organizer": {
      "command": "python",
      "args": ["C:/absolute/path/to/organizer-mcp-server/main.py"]
    }
  }
}

重新启动克劳德桌面。锤子图标(🔨) 将确认工具已加载。

运作原理

  1. 扫描 --克劳德使用 scan_folder 了解文件夹中的内容
  2. 阅读 --Claude读取具有通用名称的文件以了解其内容
  3. 计划 --Claude根据实际文件内容决定类别名称
  4. 执行 --克劳德打电话来 organize_folder 使用文件→ 类别图
  5. 验证 A. REDIRECT.txt 创建日志,显示所做的每一项更改

没有模板。没有硬编码的规则。文件夹是根据Claude对文件的理解创建的。

示例

Before:
  Downloads/
    Document1.pdf      ← Claude reads: "Q4 Sales Report"
    File2.xlsx         ← Claude reads: "Revenue Analysis"
    Untitled.doc       ← Claude reads: "Product Requirements"
    IMG_001.jpg
    IMG_002.jpg

After:
  Downloads/
    Financial_Reports/
      Document1.pdf
      File2.xlsx
    Product_Documentation/
      Untitled.doc
    Photos/
      IMG_001.jpg
      IMG_002.jpg
    REDIRECT.txt

MCP检验员测试

npx @modelcontextprotocol/inspector python main.py

在以下位置打开web UI http://localhost:5173 在那里你可以手动调用每个工具。

📄 许可证

该项目根据 MIT许可证.