Cursor MCP 文件管理器

一个模型上下文协议 (MCP) 服务器，用于使用 Cursor IDE 整理 Downloads 文件夹中的文件。

功能特性

• 自动按类型整理 Downloads 文件夹中的文件
• 支持多种文件类别：
  • 图像 (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
• Cursor IDE

安装

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建项目：

npm run build

配置

1. 配置 Cursor IDE MCP 设置：

{
  "mcpServers": {
    "file-organizer": {
      "url": "http://localhost:3001",
      "port": 3001,
      "enabled": true,
      "description": "文件整理 MCP 服务器"
    }
  }
}

2. 在 mcp-config.json 中自定义整理规则：

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

使用方法

1. 启动服务器：

npm start

2. 使用 Cursor IDE 发送命令：

// 示例命令，用于整理文件
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

可用命令

• listDir: 列出目录内容
• readFile: 读取文件内容
• writeFile: 将内容写入文件
• moveFile: 将文件移动到新位置
• createDir: 创建目录
• organizeFiles: 按类型整理文件

开发

# 在开发模式下运行，支持热重载
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start

项目结构

cursor-mcp-file-organizer/
├── src/
│   ├── server.ts      # 主要服务器实现
│   └── organizer.ts   # 文件整理逻辑
├── dist/             # 编译后的 JavaScript
├── package.json      # 依赖和脚本
├── tsconfig.json     # TypeScript 配置
└── mcp-config.json   # 整理规则

贡献

1. Fork 仓库
2. 创建您的特性分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

本项目基于 MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

• Cursor IDE 团队提供的 MCP 协议
• Node.js 社区提供的优秀工具和库