File Manager MCP

\# Dosya Yöneticisi MCP Server

Claude ile dosya ve klasör işlemlerini gerçekleştirmek için geliştirilmiş Model Context Protocol (MCP) server'ı.

\## Özellikler

\### 📄 Dosya İşlemleri

• \*\*Dosya Okuma\*\*: Herhangi bir metin dosyasının içeriğini okuyabilir
• \*\*Dosya Yazma\*\*: Yeni dosya oluşturabilir veya mevcut dosyaları düzenleyebilir
• \*\*Dosya Silme\*\*: Gereksiz dosyaları güvenli şekilde silebilir
• \*\*Dosya Bilgisi\*\*: Dosya boyutu, oluşturulma tarihi, son değişiklik tarihi gibi bilgileri getirebilir

\### 📁 Klasör İşlemleri

• \*\*Klasör Listeleme\*\*: Klasör içeriğini detaylı şekilde listeler
• \*\*Klasör Oluşturma\*\*: Yeni klasörler oluşturabilir (recursive destekli)
• \*\*Klasör Silme\*\*: Klasörleri içerikleriyle birlikte silebilir

\### 🔍 Arama İşlemleri

• \*\*Dosya Adı Arama\*\*: Dosya adlarında pattern matching ile arama
• \*\*İçerik Arama\*\*: Dosya içeriklerinde metin arama
• \*\*Recursive Arama\*\*: Alt klasörlerde de arama desteği

\## Kurulum

\### 1. Proje İndirme ve Kurulum

\```bash

git clone [repository-url]

cd file-manager-mcp

npm install

\```

\### 2. Build İşlemi

\```bash

npm run build

\```

\### 3. Claude Desktop Yapılandırması

\*\*Windows için:\*\*

%APPDATA%\Claude\claude\_desktop\_config.json dosyasını düzenleyin:

\*\*macOS için:\*\*

~/Library/Application Support/Claude/claude\_desktop\_config.json dosyasını düzenleyin:

\```json

{

"mcpServers": {

"file-manager": {

"command": "node",

"args": ["C:/path/to/your/file-manager-mcp/dist/index.js"]

}

}

}

\```

\### 4. Claude Desktop'ı Yeniden Başlatın

\## Kullanım Örnekleri

\### Dosya İşlemleri

\```

"notes.txt dosyasını oku"

"Yeni bir görev listesi oluştur ve todo.md olarak kaydet"

"eski\_dosya.txt'yi sil"

\```

\### Klasör İşlemleri

\```

"Bu klasördeki dosyaları listele"

"projeler adında yeni bir klasör oluştur"

"temp klasörünü sil"

\```

\### Arama İşlemleri

\```

"Bu klasörde 'config' içeren dosyaları bul"

"Tüm JavaScript dosyalarında 'function' kelimesini ara"

"Alt klasörlerde de 'README' dosyalarını ara"

\```

\## Güvenlik

Bu MCP server güvenlik odaklı olarak geliştirilmiştir:

• \*\*Path Traversal Koruması\*\*: ../ gibi zararlı yol manipülasyonlarını engeller
• \*\*Yasak Dizinler\*\*: Sistem kritik klasörlerine erişimi engeller
• \*\*Dosya Boyutu Limiti\*\*: Maksimum 10MB dosya boyutu
• \*\*Güvenli Uzantılar\*\*: Sadece güvenli dosya uzantılarını destekler

\### Yasak Dizinler

• /etc, /sys, /proc, /dev, /boot (Linux/macOS)
• C:\Windows, C:\System32 (Windows)
• /System, /Library/System (macOS)

\## Desteklenen Dosya Türleri

• \*\*Metin Dosyaları\*\*: .txt, .md, .log
• \*\*Kod Dosyaları\*\*: .js, .ts, .py, .html, .css
• \*\*Yapılandırma\*\*: .json, .yml, .yaml, .ini, .cfg
• \*\*Veri\*\*: .csv, .xml

\## API Referansı

\### Mevcut Araçlar

1. \*\*read\_file\*\* - Dosya okuma
2. \*\*write\_file\*\* - Dosya yazma
3. \*\*delete\_file\*\* - Dosya silme
4. \*\*list\_directory\*\* - Klasör listeleme
5. \*\*create\_directory\*\* - Klasör oluşturma
6. \*\*delete\_directory\*\* - Klasör silme
7. \*\*search\_files\*\* - Dosya adı arama
8. \*\*search\_content\*\* - Dosya içerik arama
9. \*\*get\_file\_info\*\* - Dosya/klasör bilgisi

\## Geliştirme

\### Geliştirme Modunda Çalıştırma

\```bash

npm run dev

\```

\### Değişiklikleri İzleme

\```bash

npm run watch

\```

\### Build Temizleme

\```bash

npm run clean

\```

\## Sorun Giderme

\### Claude Desktop MCP'yi Tanımıyor

1. Claude Desktop'ı tamamen kapatın
2. Config dosyasının doğru konumda olduğundan emin olun
3. JSON syntax'ının doğru olduğundan emin olun
4. Dosya yollarının doğru olduğundan emin olun
5. Claude Desktop'ı yeniden başlatın

\### Dosya İşlem Hataları

1. Dosya/klasör izinlerini kontrol edin
2. Dosya yolunun doğru olduğundan emin olun
3. Dosya boyut limitlerini kontrol edin

\### Log İnceleme

Server logları için Claude Desktop'ın developer console'unu kontrol edin.

\## Lisans

MIT License

\## Katkıda Bulunma

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

\## Changelog

\### v1.0.0

• İlk versiyon
• Temel dosya ve klasör işlemleri
• Arama fonksiyonları
• Güvenlik kontrolleri