Integrations

Provides the runtime environment for the MCP server, allowing it to organize files in the Downloads folder based on customizable rules and file categories.
Uses TypeScript for type-safe implementation of file organization logic, enabling structured command handling and configuration processing.

Cursor MCP File Organizer

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

Features

Automatically organizes files in Downloads folder by type
Supports multiple file categories:
- Images (jpg, jpeg, png, gif, webp, svg, etc.)
- Documents (pdf, doc, docx, txt, etc.)
- Archives (zip, rar, 7z, tar, etc.)
- Code files (js, ts, py, java, etc.)
- Media files (mp4, mp3, wav, etc.)
- Design files (psd, ai, sketch, etc.)
- Databases (sql, sqlite, etc.)
- Fonts (ttf, otf, woff, etc.)
Configurable organization rules
Real-time file system monitoring
SSE (Server-Sent Events) support for live updates

Prerequisites

Node.js (v14 or higher)
TypeScript
Cursor IDE

Installation

Clone the repository:

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

Install dependencies:

npm install

Build the project:

npm run build

Configuration

Configure Cursor IDE MCP settings:

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

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"
        }
        // ... other categories
      }
    }
  }
}

Usage

Start the server:

npm start

Use Cursor IDE to send commands:

// Example command to organize files
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

Available Commands

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

Development

# Run in development mode with hot reload
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
│   └── organizer.ts   # File organization logic
├── dist/             # Compiled JavaScript
├── package.json      # Dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── mcp-config.json   # Organization rules

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Cursor IDE team for the MCP protocol
Node.js community for the excellent tools and libraries

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Automatically organizes files in your Downloads folder by categorizing them into appropriate directories based on file types.