Content
[](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
Connection Info
You Might Also Like
Time
Obtaining current time information and converting time between different...
bytebot
Bytebot is a self-hosted AI desktop agent that automates computer tasks...
inbox-zero
The world's best AI personal assistant for email. Open source app to help...
DesktopCommanderMCP
This is MCP server for Claude that gives it terminal control, file system...
ClaudeComputerCommander
This is an MCP server that provides terminal control, file system search,...
astron-rpa
Agent-ready RPA suite with out-of-the-box automation tools. Built for...