README.md
AI-powered system for managing, organizing, and renaming files intelligently.
📁 Super-Organizer MCP 🚀
מערכת בינה מלאכותית לניהול, ארגון ושינוי שמות קבצים חכם
מערכת זו מאפשרת ל-Claude "להשתלט" על הבלגן בתיקיות שלך. היא לא רק מזיזה קבצים, היא מבינה מה כתוב בתוכם ומציעה שמות חדשים ומשמעותיים בעברית.
🧠 טכניקות ומתודולוגיה
המערכת פועלת באמצעות שלוש שכבות לוגיות מתקדמות:
1. ניתוח תוכן חכם (Smart Buffer Analysis)
במקום לקרוא קבצים שלמים (מה שעלול לגרום לאיטיות), המערכת דוגמת את ה-800 התווים הראשונים בלבד.
- Heuristic Identification: ה-AI מזהה דפוסים (כמו כותרות, פונקציות קוד או תאריכים) כדי להבין את מהות הקובץ.
- Encoding Safety: שימוש ב-
utf-8עם התעלמות משגיאות מאפשר לקרוא קבצים מגוונים מבלי שהמערכת תקרוס.
2. הגנה מפני קבצי מדיה (Binary Shielding)
כדי למנוע מה-AI "להזות" (Hallucinate) תוכן של תמונות או וידאו:
- המערכת מזהה סיומות בינאריות מראש (JPG, PNG, MP4).
- קבצים אלו מוגדרים אוטומטית כ-"ללא תצוגה מקדימה", מה שכופה על ה-AI לשלוח אותם לתיקיית "למיון ידני" במקום לנחש את תוכנם.
3. נירמול נתיבים (Path Normalization)
המערכת יודעת להתמודד עם המורכבות של Windows:
- הופכת נתיבים ל-"Absolute Paths" כדי למנוע טעויות מיקום.
- מתקנת בעיות של סלאשים הפוכים (
\) שנוצרים לעיתים בעבודה מול ממשקי AI.
🛠 דרישות מערכת
- Python 3.10+
- Claude Desktop App
- FastMCP Framework
🖼 Screenshots Gallery
ריכזנו כאן את כל שלבי העבודה, מהסריקה הראשונית ועד התוצאה הסופית בתיקייה:
| Stage | Visual | Description |
|---|---|---|
| 1. Analysis & Planning |   |
Claude identifies files, displays previews, and suggests Hebrew names. |
| 2. Execution Summary |  |
A log showing the final results of the organization process. |
| 3. Folder: BEFORE |  |
The original messy state of the folder before processing. |
| 4. Folder: AFTER |  |
The final result: organized folders and clear Hebrew filenames. |
🚀 הוראות הרצה
- ודאו ששרת ה-MCP רץ ב-Claude Desktop.
- פתחו צ'אט וכתבו:
"תסדר לי את התיקייה [נתיב]". - עברו על הטבלה שקלוד יציע ואשרו את הביצוע.
Tools (1)
organize_folderAnalyzes a directory, categorizes files, and suggests meaningful names for files and folders.Configuration
claude_desktop_config.json
{"mcpServers": {"file-organizer": {"command": "python", "args": ["path/to/main.py"]}}}Try it
→Organize the files in my Documents folder.
→Please scan the folder at C:/Users/Name/Downloads and suggest a better structure.
→Review the files in my project directory and rename them to be more descriptive.
→Help me clean up my messy desktop folder by categorizing the files.