Downloads Organizer

🚀 Cursor MCP File Organizer for Downloads Folder

A Model Context Protocol (MCP) server for organizing and managing files in the Downloads folder using the Cursor IDE.

🚀 Quick Start

The Cursor MCP File Organizer is a powerful tool designed to streamline the management of your Downloads folder. With this tool, you can effortlessly organize your files into different categories based on their types.

✨ Features

• Automatically organize files in the Downloads folder.
• Support for multiple file categories:
  • Images (jpg, jpeg, png, gif, webp, svg, etc.)
  • Documents (pdf, doc, docx, txt, etc.)
  • Compressed files (zip, rar, 7z, tar, etc.)
  • Code files (js, ts, py, java, etc.)
  • Media files (mp4, mp3, wav, etc.)
  • Design files (psd, ai, sketch, etc.)
  • Database files (sql, sqlite, etc.)
  • Font files (ttf, otf, woff, etc.)
• Configurable organization rules.
• Real-time file system monitoring.
• Support for SSE (Server-Sent Events) real-time updates.

📦 Installation

Prerequisites

• Node.js (v14 or higher)
• TypeScript
• Cursor IDE

Steps

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

📚 Documentation

Configuration Guide

1. Configure Cursor IDE MCP settings:

{
  "mcpServers": {
    "file-organizer": {
      "url": "http://localhost:3001",
      "port": 3001,
      "enabled": true,
      "description": "File organization MCP server"
    }
  }
}

2. Customize organization rules in mcp-config.json:

{
  "version": "1.0",
  "rules": {
    "downloads": {
      "path": "~/Downloads",
      "organizeBy": {
        "images": {
          "extensions": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"],
          "destination": "~/Downloads/Pictures"
        }
        // Add other categories continuously
      }
    }
  }
}

Usage Instructions

1. Start the server:

npm start

2. Send commands using Cursor IDE:

// Example command for organizing files
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

Available Commands

• listDir: List directory contents.
• readFile: Read file contents.
• writeFile: Write file contents.
• moveFile: Move a file to a new location.
• createDir: Create a directory.
• organizeFiles: Organize files by type.

Development Information

# Run in development mode with hot reloading
npm run dev

# Build the project
npm run build

# Start the server
npm start

Project Structure

cursor-mcp-file-organizer/
├── src/
│   ├── server.ts      # Main server implementation file
│   └── organizer.ts   # File organization logic file
├── dist/             # Compiled JavaScript folder
├── package.json      # Project dependencies and script information
├── mcp-config.json    # Organization rule configuration file
└── README.md         # Project documentation

Contribution Guide

Contributions from the community are welcome! Please refer to CONTRIBUTING.md to participate in the project.

📄 License

This project is licensed under the MIT License.