Local File Organizer

🚀 ローカルファイル整理器

このプロジェクトはPythonベースのファイル整理システムで、モデルコンテキストプロトコル（MCP）を利用して、ディレクトリ間で安全にファイルを管理および整理します。

🚀 クイックスタート

このローカルファイル整理器は、MCPフレームワークを使用して、ユーザー指定のディレクトリ内のファイルを安全に管理および整理します。以下に、使用方法の概要を説明します。

✨ 主な機能

• ディレクトリセキュリティ：明示的に許可されたディレクトリのみを操作対象とします。
• スマート分類：拡張子に基づいて、以下のカテゴリにファイルを整理します。
  • ドキュメント（PDF、DOC、DOCX、TXT、RTF、MD、HTML、JSON、CSVなど）
  • 画像（JPG、PNG、GIF、SVG、WEBP、HEICなど）
  • ビデオ（MP4、MOV、AVI、MKVなど）
  • オーディオ（MP3、WAV、OGG、FLACなど）
  • アーカイブ（ZIP、RAR、7Z、TARなど）
  • コード（PY、JS、HTML、CSS、Javaなど）
  • アプリケーション（DMG、EXE、MSIなど）
  • その他（未分類のファイルタイプ）
• プロジェクト検出：コードリポジトリを識別し、干渉を避けます。
• 再帰的処理：ネストされたディレクトリ構造を分析および整理することができます。
• リソース効率：大規模なディレクトリ構造に対してパフォーマンスが最適化されています。
• 詳細分析：ファイルのタイプ別分布に関する洞察を提供します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/diganto-deb/local_file_organizer.git
cd local_file_organizer

# 依存関係をインストールする
pip install -r requirements.txt

💻 使用例

基本的な使用法

1. 許可ディレクトリの設定

プロジェクトディレクトリ内の .cursor/mcp.json ファイルを作成または編集します。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/organize/dir1",
        "/path/to/organize/dir2"
      ]
    }
  }
}

パスを、MCPサーバーがアクセスすることを許可するディレクトリに置き換えてください。

2. MCPサーバーの有効化

.cursor/mcp.json ファイルを設定した後、以下の手順でMCPサーバーを有効化します。

1. Cursorを再起動します。
2. Cursorの設定（⚙️）を開きます。
3. MCP に移動します。
4. MCPサーバーのリストに filesystem サーバーが表示されるはずです。
   • サーバー名は "filesystem" と表示されるはずです。
5. サーバー名の横にある切り替えスイッチをクリックして、サーバーを有効化します。

3. ファイル整理コマンドの使用

MCPサーバーを有効化したら、Cursorのプロキシ内で直接ファイル整理コマンドを使用できます。

# 利用可能なすべてのカテゴリをリストする
list_categories

# ディレクトリを分析して変更を加えない
analyze_directory /path/to/directory

# ターゲットディレクトリに分類フォルダを作成する
create_category_directories /path/to/target

# ファイルをタイプ別に整理する
organize_files /path/to/directory

# ファイルを検索する
search_files /path/to/directory "*.jpg"

🔧 技術詳細

このシステムは以下を使用しています。

• MCP Python SDK：コアサーバーの実装に使用されます。
• Filesystem MCP Server：ファイルシステムの処理に使用されます。
• Pathlib：パス操作に使用されます。
• 型アノテーション：コードの保守性と明瞭性を高めるために使用されます。

📚 ドキュメント

計画されている機能

将来のバージョンでは、以下の機能が追加されます。

• より多くのファイルタイプと分類のサポート
• グラフィカルユーザーインターフェイス（GUI）の提供
• クラウドストレージサポートの統合
• 強化されたセキュリティと権限管理

貢献方法

貢献したい場合は、プロジェクトリポジトリを参照してください。https://github.com/diganto-deb/local_file_organizer

📄 ライセンス

このソフトウェアはMITライセンスの下で保護されています。詳細については、LICENSE を参照してください。