What is Cursor Mcp File Organizer

Cursor MCP File Organizer is a Model Context Protocol (MCP) server designed to automatically sort files in the Downloads folder of macOS by file type using Cursor IDE.

Use cases

Use cases include organizing downloaded images into a dedicated folder, sorting documents for easy access, managing code files for developers, and keeping media files organized for quick retrieval.

How to use

To use Cursor MCP File Organizer, clone the repository, install the dependencies, build the project, configure the MCP settings in Cursor IDE, and start the server. You can then send commands to organize files in the Downloads folder.

Key features

Key features include automatic organization of files by type, support for multiple file categories (images, documents, archives, code files, media files, design files, databases, fonts), configurable organization rules, real-time file system monitoring, and SSE support for live updates.

Where to use

Cursor MCP File Organizer is primarily used in personal computing environments, particularly for macOS users who frequently download and manage various file types.

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

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

Configuration

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:

Usage

1. Start the server:

npm start

2. 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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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