Cursor MCP File Organizer

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.

Cursor MCP 文件管理器

使用 Cursor IDE 组织下载文件夹中的文件的模型上下文协议 (MCP) 服务器。

特征

  • 自动按类型组织下载文件夹中的文件
  • 支持多种文件类别:
    • 图像(jpg、jpeg、png、gif、webp、svg 等)
    • 文档(pdf、doc、docx、txt 等)
    • 档案(zip、rar、7z、tar 等)
    • 代码文件(js、ts、py、java等)
    • 媒体文件(mp4、mp3、wav 等)
    • 设计文件(psd、ai、sketch等)
    • 数据库(sql、sqlite等)
    • 字体(ttf、otf、woff 等)
  • 可配置的组织规则
  • 实时文件系统监控
  • SSE(服务器发送事件)支持实时更新

先决条件

  • Node.js(v14 或更高版本)
  • TypeScript
  • 游标 IDE

安装

  1. 克隆存储库:
git clone https://github.com/AlexanderVTr/cursor-mcp-file-organizer.git cd cursor-mcp-file-organizer
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

配置

  1. 配置 Cursor IDE MCP 设置:
{ "mcpServers": { "file-organizer": { "url": "http://localhost:3001", "port": 3001, "enabled": true, "description": "File organization MCP server" } } }
  1. mcp-config.json中自定义组织规则:
{ "version": "1.0", "rules": { "downloads": { "path": "~/Downloads", "organizeBy": { "images": { "extensions": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"], "destination": "~/Downloads/Pictures" } // ... other categories } } } }

用法

  1. 启动服务器:
npm start
  1. 使用Cursor 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

贡献

  1. 分叉存储库
  2. 创建你的功能分支( git checkout -b feature/amazing-feature
  3. 提交您的更改( git commit -m 'Add some amazing feature'
  4. 推送到分支( git push origin feature/amazing-feature
  5. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

致谢

  • MCP 协议的 Cursor IDE 团队
  • Node.js 社区提供优秀的工具和库
-
security - not tested
F
license - not found
-
quality - not tested

根据文件类型将下载文件夹中的文件分类到适当的目录中,从而自动组织文件。

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Available Commands
              1. Development
                1. Project Structure
                  1. Contributing
                    1. License
                      1. Acknowledgments
                        ID: 0z5jz29ycf