# 📁 Super-Organizer MCP 🚀
**מערכת בינה מלאכותית לניהול, ארגון ושינוי שמות קבצים חכם**

מערכת זו מאפשרת ל-Claude "להשתלט" על הבלגן בתיקיות שלך. היא לא רק מזיזה קבצים, היא מבינה מה כתוב בתוכם ומציעה שמות חדשים ומשמעותיים בעברית.

[לצפייה בסרטון הסבר והדגמה של הפרויקט (Demo) לחצו כאן](https://drive.google.com/file/d/18nsgS-ctP3MB4fwRRGfA-YZMpPJMcgN9/view?usp=sharing)

---

## 🧠 טכניקות ומתודולוגיה

המערכת פועלת באמצעות שלוש שכבות לוגיות מתקדמות:

### 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** | ![Scan and Plan](Screenshots/1.png)![Scan and Plan](Screenshots/2.png) | Claude identifies files, displays previews, and suggests Hebrew names. |
| **2. Execution Summary** | ![Summary](Screenshots/3.png) | A log showing the final results of the organization process. |
| **3. Folder: BEFORE** | ![Before](Screenshots/4.png) | The original messy state of the folder before processing. |
| **4. Folder: AFTER** | ![After](Screenshots/5.png) | The final result: organized folders and clear Hebrew filenames. |



---

## 🚀 הוראות הרצה
1. ודאו ששרת ה-MCP רץ ב-Claude Desktop.
2. פתחו צ'אט וכתבו: `"תסדר לי את התיקייה [נתיב]"`.
3. עברו על הטבלה שקלוד יציע ואשרו את הביצוע.