Downloads Organizer

🚀 Cursor MCP ファイル整理ツールでDownloadsフォルダを管理する

Cursor IDEを使用してDownloadsフォルダ内のファイルを整理・管理するためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このセクションでは、Cursor MCP ファイル整理ツールをすぐに使い始めるための基本的な手順を説明します。

✨ 主な機能

• 自動整理：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（Server-Sent Events）サポート：リアルタイム更新をサポートします。

📦 インストール

前提条件

• 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. サーバーを起動します：

npm start

2. Cursor IDEを使用してコマンドを送信します：

// ファイルを整理するためのサンプルコマンド
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

高度な使用法

// 高度なシナリオでのコマンド送信例
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads",
    customRules: true // カスタムルールを適用する場合
  }
}

📚 ドキュメント

設定ガイド

Cursor IDE MCP設定の構成

{
  "mcpServers": {
    "file-organizer": {
      "url": "http://localhost:3001",
      "port": 3001,
      "enabled": true,
      "description": "ファイル整理 MCP サーバー"
    }
  }
}

mcp-config.jsonでの整理ルールのカスタマイズ

{
  "version": "1.0",
  "rules": {
    "downloads": {
      "path": "~/Downloads",
      "organizeBy": {
        "images": {
          "extensions": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"],
          "destination": "~/Downloads/Pictures"
        }
        // 他のカテゴリを追加してください
      }
    }
  }
}

利用可能なコマンド

• 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      # プロジェクトの依存関係とスクリプト情報
├── mcp-config.json    # 整理ルールの設定ファイル
└── README.md         # プロジェクトの説明ドキュメント

貢献ガイド

コミュニティからの貢献を歓迎します！CONTRIBUTING.mdを参照してプロジェクトに参加してください。

📄 ライセンス

このプロジェクトは MIT License に基づいています。