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:
- Construir el proyecto:
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:
- Utilice Cursor IDE para enviar comandos:
// Example command to organize files
{
command: "organizeFiles",
args: {
path: "~/Downloads"
}
}
Comandos disponibles
listDir
: Lista el contenido del directorioreadFile
: Leer el contenido del archivowriteFile
: Escribe el contenido en el archivomoveFile
: Mueve el archivo a una nueva ubicacióncreateDir
: Crear directorioorganizeFiles
: 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