Downloads Organizer

🚀 使用 Cursor MCP 文件組織器管理 Downloads 文件夾

本項目是一個模型上下文協議（MCP）服務器，可藉助 Cursor IDE 對 Downloads 文件夾中的文件進行高效組織與管理，有效提升文件管理效率。

🚀 快速開始

先決條件

• Node.js（v14 或更高版本）
• TypeScript
• Cursor IDE

安裝步驟

1. 克隆倉庫：

git clone https://github.com/AlexanderVTr/cursor-mcp-file-organizer.git
cd cursor-mcp-file-organizer

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

配置指南

1. 配置 Cursor IDE MCP 設置：

{
  "mcpServers": {
    "file-organizer": {
      "url": "http://localhost:3001",
      "port": 3001,
      "enabled": true,
      "description": "文件整理 MCP 服務器"
    }
  }
}

2. 自定義整理規則在 mcp-config.json：

{
  "version": "1.0",
  "rules": {
    "downloads": {
      "path": "~/Downloads",
      "organizeBy": {
        "images": {
          "extensions": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"],
          "destination": "~/Downloads/Pictures"
        }
        // 其他類別繼續添加
      }
    }
  }
}

使用說明

1. 啟動服務器：

npm start

2. 使用 Cursor IDE 發送命令：

// 示例命令用於整理文件
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

✨ 主要特性

• 自動整理：自動對 Downloads 文件夾中的文件進行整理。
• 多類別支持：支持多種文件類別，包括但不限於：
  • 圖片 (jpg, jpeg, png, gif, webp, svg 等)
  • 文檔 (pdf, doc, docx, txt 等)
  • 壓縮包 (zip, rar, 7z, tar 等)
  • 代碼文件 (js, ts, py, java 等)
  • 媒體文件 (mp4, mp3, wav 等)
  • 設計文件 (psd, ai, sketch 等)
  • 數據庫文件 (sql, sqlite 等)
  • 字體文件 (ttf, otf, woff 等)
• 規則可配置：支持用戶自定義文件整理規則。
• 即時監控：即時監控文件系統的變化。
• 即時更新：支持 SSE（Server-Sent Events）即時更新。

💻 使用示例

基礎用法

# 啟動服務器
npm start

高級用法

// 使用 Cursor IDE 發送命令進行文件整理
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

📚 詳細文檔

可用命令

• listDir：列出目錄內容
• readFile：讀取文件內容
• writeFile：寫入文件內容
• moveFile：移動文件到新位置
• createDir：創建目錄
• organizeFiles：按類型整理文件

開發信息

# 以開發模式運行並啟用熱重載
npm run dev

# 構建項目
npm run build

# 啟動服務器
npm start

項目結構

cursor-mcp-file-organizer/
├── src/
│   ├── server.ts      # 主服務器實現文件
│   └── organizer.ts   # 文件整理邏輯文件
├── dist/             # 編譯後的 JavaScript 文件夾
├── package.json      # 項目依賴和腳本信息
├── mcp-config.json    # 整理規則配置文件
└── README.md         # 項目說明文檔

貢獻指南

歡迎社區貢獻！請參考 CONTRIBUTING.md 參與項目。

📄 許可證

本項目遵循 MIT License。