Filesystem MCP

Anthropic'in resmi MCP sunucusu. Yapay zekâya argüman olarak verdiğin izinli dizin(ler) içinde dosya okuma/yazma/arama/taşıma yeteneği kazandırır. Dizin dışına kesinlikle çıkamaz — path traversal girişimleri sunucu tarafında reddedilir.

Ne işe yarar?

• Proje kodunu AI'a bütün olarak gezdirme (Claude Desktop / Cursor'da — Claude Code bunu zaten yapar)
• Çok dosyalı refactor'lar — AI tek başına arayıp değiştirir
• Dosya organizasyonu: taşıma, yeniden adlandırma, klasörleme
• Büyük metin dosyalarında arama (içerik + isim)
• Template'den yeni dosya üretme ("şu klasöre şu yapıda üret")
• Log dosyalarını AI'a okutup özetletme

Yetenekler (MCP Tools)

Tool	Ne yapar
read_file	Bir dosyanın tamamını oku
read_multiple_files	Birden çok dosyayı tek çağrıda oku
write_file	Dosya yaz / üzerine yaz
edit_file	Satır tabanlı diff edit
create_directory	Klasör oluştur
list_directory	Klasör içeriğini listele (dosya/klasör ayrımı)
directory_tree	Alt klasörleri ağaç yapısında döner
move_file	Dosya/klasör taşı veya yeniden adlandır
search_files	Glob pattern ile dosya ismine göre ara
get_file_info	Metadata (boyut, tarih, permission)

Kurulum

Claude Code

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem \
  /Users/me/Documents \
  /Users/me/Projects

Birden fazla dizin verebilirsin. Argüman olarak geçmediğin dizin erişilemez.

Claude Desktop / Cursor

claude_desktop_config.json veya ~/.cursor/mcp.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/me/Documents",
        "/Users/me/Projects"
      ]
    }
  }
}

Windows için path'leri C:\\Users\\Me\\Documents formatında ver (çift backslash).

Docker ile izole çalıştırma

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--mount", "type=bind,src=/Users/me/Projects,dst=/projects",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

Güvenlik

MCP sunucusuna verdiğin dizin, AI'ın sınırsız okuyabildiği ve yazabildiği alandır. Bilinçli ol:

• Ev dizinini (/Users/me veya ~) verme. .ssh, .aws, keychain, browser history burada.
• Proje kökünü ver — sadece üzerinde çalıştığın klasör.
• Secret dosyaları (.env, credentials.json, SSH keys) olan dizini vereceksen gitignore'a benzer davranış yok — AI istediğini okur.
• Prod kodu olan bir repo için: yazma izinleri riskli. Read-only mod'u MCP_READ_ONLY=1 env var ile aktif et (destekleniyorsa) veya sadece backup üzerine point et.
• Shared repos / şirket laptopları: admin'le teyitleş.

Örnek kullanımlar

Refactor

"src/legacy/ altındaki tüm .js dosyalarını .ts'ye çevir, type annotation'ları ekle, unused import'ları sil."

AI search_files ile listeler, her dosyayı read_file ile okur, write_file ile yazar. Sonunda özeti döner.

Template üretimi

"templates/component/ altındaki yapının aynısını src/components/UserCard/ olarak oluştur, __NAME__ yerine UserCard koy."

Log analizi

"logs/prod-2026-04-22.log içinde ERROR seviyeli 50'den fazla aynı hata var mı, varsa hangisi?"

Sınırlar

• Binary dosyaları okuyabilir ama anlamı sınırlı (görsel/video için ayrı araç gerek)
• Sembolik link takibi güvenlik nedeniyle kısıtlı

• 1MB dosyalarda performans düşer — büyük dosyaya bakacaksa AI'a offset+limit ile söyle

• Real-time dosya izleme yok (watch mode)
• Permission (chmod/chown) değiştirme yok

Sorun giderme

Belirti	Olası sebep	Çözüm
permission denied	AI izinli dizin dışına çıkmaya çalışıyor	Argümanlara o dizini ekle
ENOENT	Path yanlış	Mutlak yol ver, tilde ~ çözümlenmez
Bağlantı kurulmuyor	npx cache'lenmiş eski sürüm	npx clear-npx-cache, sonra yeniden
Windows'ta path hatası	Tek backslash	C:\\Users\\... (çift backslash)

Doğrulama

Kurduktan sonra Claude Code'da:

/mcp

filesystem satırı yeşil olmalı. Yoksa /mcp > filesystem > "View logs" ile detay.

---

Resmi repo: github.com/modelcontextprotocol/servers · Anthropic maintained