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) サーバー。

特徴

ダウンロードフォルダ内のファイルを種類別に自動的に整理します
複数のファイルカテゴリをサポートします:
- 画像 (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

インストール

リポジトリをクローンします。

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

依存関係をインストールします:

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 ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

MCPプロトコルのCursor IDEチーム
優れたツールとライブラリを提供するNode.jsコミュニティ

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

ファイルの種類に基づいて適切なディレクトリに分類し、ダウンロードフォルダー内のファイルを自動的に整理します。

Cursor MCP File Organizer