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

Related MCP server: File Organizer AI MCP

Prerrequisitos

• Node.js (v14 o superior)

• Mecanografiado

• IDE de cursor

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Configuración

1. Configurar los ajustes de Cursor IDE MCP:

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

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

1. Iniciar el servidor:

npm start

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

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

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