[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/alexandervtr-cursor-mcp-file-organizer-badge.png)](https://mseep.ai/app/alexandervtr-cursor-mcp-file-organizer)

# 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:

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

2. Install dependencies:

```bash
npm install
```

3. Build the project:

```bash
npm run build
```

## Configuration

1. Configure Cursor IDE MCP settings:

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

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

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

## Usage

1. Start the server:

```bash
npm start
```

2. Use Cursor IDE to send commands:

```typescript
// 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

```bash
# 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

Certified by MCP Review https://mcpreview.com/mcp-servers/alexandervtr/cursor-mcp-file-organizer