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.

커서 MCP 파일 정리기

Cursor IDE를 사용하여 다운로드 폴더의 파일을 구성하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

다운로드 폴더에 파일을 유형별로 자동으로 정리합니다.
다양한 파일 카테고리를 지원합니다:
- 이미지(jpg, jpeg, png, gif, webp, svg 등)
- 문서(pdf, doc, docx, txt 등)
- 아카이브(zip, rar, 7z, tar 등)
- 코드 파일(js, ts, py, java 등)
- 미디어 파일(mp4, mp3, wav 등)
- 디자인 파일(psd, ai, 스케치 등)
- 데이터베이스(sql, sqlite 등)
- 글꼴(ttf, otf, woff 등)
구성 가능한 조직 규칙
실시간 파일 시스템 모니터링
라이브 업데이트를 위한 SSE(Server-Sent Events) 지원

필수 조건

Node.js(v14 이상)
타입스크립트
커서 IDE

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

구성

커서 IDE MCP 설정 구성:

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

mcp-config.json 에서 조직 규칙을 사용자 정의합니다.

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

용법

서버를 시작합니다:

npm start

커서 IDE를 사용하여 명령을 보내세요:

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

사용 가능한 명령

listDir : 디렉토리 내용 나열
readFile : 파일 내용 읽기
writeFile : 파일에 내용 쓰기
moveFile : 파일을 새 위치로 이동합니다.
createDir : 디렉토리 생성
organizeFiles : 파일 유형을 기준으로 정리

개발

# Run in development mode with hot reload
npm run dev

# Build the project
npm run build

# Start the server
npm start

프로젝트 구조

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

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

MCP 프로토콜을 위한 커서 IDE 팀
뛰어난 도구와 라이브러리를 제공하는 Node.js 커뮤니티

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

파일 유형에 따라 적절한 디렉토리에 파일을 분류하여 다운로드 폴더에 자동으로 정리합니다.

Cursor MCP File Organizer