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.

Organizador de archivos Cursor MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para organizar archivos en su carpeta de Descargas usando Cursor IDE.

Características

Organiza automáticamente los archivos en la carpeta Descargas por tipo
Admite múltiples categorías de archivos:
- Imágenes (jpg, jpeg, png, gif, webp, SVG, etc.)
- Documentos (pdf, doc, docx, txt, etc.)
- Archivos (zip, rar, 7z, tar, etc.)
- Archivos de código (js, ts, py, java, etc.)
- Archivos multimedia (mp4, mp3, wav, etc.)
- Archivos de diseño (psd, ai, sketch, etc.)
- Bases de datos (sql, sqlite, etc.)
- Fuentes (ttf, otf, woff, etc.)
Reglas de organización configurables
Monitoreo del sistema de archivos en tiempo real
Compatibilidad con SSE (eventos enviados por el servidor) para actualizaciones en vivo

Prerrequisitos

Node.js (v14 o superior)
Mecanografiado
IDE de cursor

Instalación

Clonar el repositorio:

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

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Configuración

Configurar los ajustes de Cursor IDE MCP:

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

Personalizar las reglas de la organización en mcp-config.json :

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

Uso

Iniciar el servidor:

npm start

Utilice Cursor IDE para enviar comandos:

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

Comandos disponibles

listDir : Lista el contenido del directorio
readFile : Leer el contenido del archivo
writeFile : Escribe el contenido en el archivo
moveFile : Mueve el archivo a una nueva ubicación
createDir : Crear directorio
organizeFiles : Organiza archivos por tipo

Desarrollo

# Run in development mode with hot reload
npm run dev

# Build the project
npm run build

# Start the server
npm start

Estructura del proyecto

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

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Equipo de Cursor IDE para el protocolo MCP
Comunidad Node.js por sus excelentes herramientas y bibliotecas

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Organiza automáticamente los archivos en su carpeta de Descargas categorizándolos en directorios apropiados según los tipos de archivos.

Cursor MCP File Organizer