Cursor MCP File Organizer

Cursor MCP File Organizer

Um servidor Model Context Protocol (MCP) para organizar arquivos na sua pasta Downloads usando o Cursor IDE.

Recursos

• Organiza automaticamente arquivos na pasta Downloads por tipo
• Suporta múltiplas categorias de arquivos:
  • Imagens (jpg, jpeg, png, gif, webp, svg, etc.)
  • Documentos (pdf, doc, docx, txt, etc.)
  • Arquivos compactados (zip, rar, 7z, tar, etc.)
  • Arquivos de código (js, ts, py, java, etc.)
  • Arquivos de mídia (mp4, mp3, wav, etc.)
  • Arquivos de design (psd, ai, sketch, etc.)
  • Bancos de dados (sql, sqlite, etc.)
  • Fontes (ttf, otf, woff, etc.)
• Regras de organização configuráveis
• Monitoramento do sistema de arquivos em tempo real
• Suporte a SSE (Server-Sent Events) para atualizações ao vivo

Pré-requisitos

• Node.js (v14 ou superior)
• TypeScript
• Cursor IDE

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Configuração

1. Configure as configurações MCP do Cursor IDE:

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

2. Personalize as regras de organização em 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. Inicie o servidor:

npm start

2. Use o Cursor IDE para enviar comandos:

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

Comandos Disponíveis

• listDir: Listar o conteúdo do diretório
• readFile: Ler o conteúdo do arquivo
• writeFile: Escrever conteúdo no arquivo
• moveFile: Mover arquivo para novo local
• createDir: Criar diretório
• organizeFiles: Organizar arquivos por tipo

Desenvolvimento

# Run in development mode with hot reload
npm run dev

# Build the project
npm run build

# Start the server
npm start

Estrutura do Projeto

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

Contribuindo

1. Faça um fork do repositório
2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
4. Envie para a branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

• Equipe do Cursor IDE pelo protocolo MCP
• Comunidade Node.js pelas excelentes ferramentas e bibliotecas

Certificado pela MCP Review https://mcpreview.com/mcp-servers/alexandervtr/cursor-mcp-file-organizer