Skip to main content
Glama
Sign In
enesjakozh

Cursor MCP File Organizer

by AlexanderVTr
GitHub
TypeScript
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Clone the repository:
git clone https://github.com/AlexanderVTr/cursor-mcp-file-organizer.git cd cursor-mcp-file-organizer
  1. Install dependencies:
npm install
  1. 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" } } }
  1. 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

  1. Start the server:
npm start
  1. 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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Available Commands
              1. Development
                1. Project Structure
                  1. Contributing
                    1. License
                      1. Acknowledgments

                        Related MCP Servers

                        • Website Downloader

                          pskill9
                          A
                          security
                          F
                          license
                          A
                          quality
                          Provides a tool to download entire websites using wget. It preserves the website structure and converts links to work locally.
                          Last updated -
                          1
                          40
                          JavaScript
                          • Apple
                          • Linux

                        • Google Drive MCP Server

                          felores
                          -
                          security
                          A
                          license
                          -
                          quality
                          Enables integration with Google Drive for listing, reading, and searching over files, supporting various file types with automatic export for Google Workspace files.
                          Last updated -
                          1,495
                          9
                          JavaScript
                          MIT License

                        • MCP Source Tree Server

                          owayo
                          A
                          security
                          A
                          license
                          A
                          quality
                          Generates a JSON file tree from a specified directory's 'src' folder, adhering to '.gitignore' rules, allowing for quick project structure review in Claude.
                          Last updated -
                          1
                          Python
                          MIT License

                        • File Rank MCP Server

                          admica
                          -
                          security
                          A
                          license
                          -
                          quality
                          A tool that helps rank codebase files by importance (1-10 scale), track file dependencies, and provide summaries, all accessible through a simple JSON-based interface.
                          Last updated -
                          2
                          TypeScript
                          GPL 3.0
                          • Linux

                        View all related MCP servers

                        Appeared in Searches

                        New MCP Servers

                        ID: 0z5jz29ycf