Dosya Sistemi MCP Sunucusu

“Dosya Sistemi” MCP Sunucusu ne işe yarar?

Dosya Sistemi MCP Sunucusu, Model Context Protocol (MCP) aracılığıyla yerel dosya sistemine güvenli ve programlanabilir erişim sunar. AI asistanlarının ve diğer istemcilerin, sunucunun bulunduğu makinede dosya ve dizinlerle etkileşim kurmasını sağlar; okuma, yazma, kopyalama, taşıma, arama, düzenleme ve dizin yönetimi gibi işlemleri kolaylaştırır. Geliştirme iş akışlarını iyileştirmek için tasarlanan bu sunucu, dosya işlemleri için API’ler sunarken, yalnızca izin verilen dizinler ve yol doğrulama gibi sıkı güvenlik önlemleri uygular ve yetkisiz erişimi engeller. Bu sayede AI ajanlarını dosya yönetimi görevlerine bağlamak için ideal bir köprü görevi görür; kod tabanı keşfi, otomatik dosya düzenleme, toplu arama-değiştirme gibi kullanım senaryalarını ayrıntılı kontrol ve güçlü güvenlik önlemleriyle destekler.

Prompt Listesi

Depo belgelerinde veya dosyalarında özel bir prompt şablonundan bahsedilmemiştir.

Kaynak Listesi

Depoda açıkça belgelenmiş bir MCP “kaynağı” yoktur. Sunucu, dosya sistemi işlemlerini araç olarak sunmaya odaklanır.

Araç Listesi

• read_file
  Bir dosyanın içeriğini tamamen okur.
• read_multiple_files
  Birden fazla dosyanın içeriğini tek seferde okur.
• write_file
  Yeni bir dosya oluşturur ya da mevcut bir dosyanın içeriğini yenisiyle değiştirir.
• copy_file
  Dosya ve dizinleri kopyalar.
• move_file
  Dosya ve dizinleri taşır veya yeniden adlandırır.
• delete_file
  Dosya veya dizini, isteğe bağlı olarak yinelemeli şekilde siler.
• modify_file
  Bir dosya içinde metni, metin eşleştirme veya regex ile bulup değiştirir.
• list_directory
  Belirtilen bir yoldaki tüm dosya ve dizinleri listeler.
• create_directory
  Yeni bir dizin oluşturur veya mevcutsa varlığını garanti eder.
• tree
  Bir dizin yapısının hiyerarşik JSON gösterimini döndürür.
• search_files
  Belirli bir deseni eşleyen dosya ve dizinleri yinelemeli olarak arar.
• search_within_files
  Dizin ağaçlarında dosya içeriklerinde metin arar.
• get_file_info
  Bir dosya veya dizin hakkında ayrıntılı meta verileri alır.
• list_allowed_directories
  Sunucunun erişmesine izin verilen dizinlerin listesini döndürür.

Bu MCP Sunucusunun Kullanım Alanları

• Otomatik Kod Tabanı Keşfi
  Geliştiriciler ve AI asistanları, proje klasörlerini hızlıca keşfedebilir, dosyaları listeleyebilir ve kod desenleri veya dosya türlerini arayabilir.
• Toplu Dosya Düzenleme
  modify_file aracıyla, birden çok dosyada düz metin veya regex ile bul-değiştir işlemleri yapılabilir; kod veya metin tabanlı düzenlemeler hızlıca tamamlanır.
• Güvenli Dosya Yönetimi
  Belirli dizinler içinde okuma, yazma, taşıma, kopyalama veya silme işlemleri için kontrollü bir ortam sunar; otomasyon için idealdir ve tüm sistemi riske atmaz.
• İçerik Arama ve Keşif
  Belirli desenleri eşleyen veya belirli içerik içeren dosya/dizinleri hızlıca bulur; dokümantasyon, yeniden düzenleme veya araştırma görevlerini destekler.
• Otomatik Yedekleme veya Organizasyon
  copy_file, move_file ve tree araçlarıyla, yedekleme rutinleri otomatikleştirilebilir, proje yapıları yeniden düzenlenebilir veya dizin yapıları aynalanabilir.

Kurulum Nasıl Yapılır

Windsurf

1. Go’nun kurulu olduğundan ve MCP Dosya Sistemi Sunucusu ikili dosyasının mevcut olduğundan emin olun.

2. Windsurf yapılandırma dosyanızı açın.

3. Aşağıdaki JSON parçasıyla MCP sunucusunu ekleyin:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Windsurf’u yeniden başlatın.

5. “filesystem” MCP sunucusunun MCP entegrasyonlarınızda göründüğünü doğrulayın.

API anahtarlarını güvenli hale getirme (ortam değişkeni ile örnek)

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Claude

1. Dosya Sistemi MCP Sunucusunu indirin ve kurun.

2. Claude’un MCP entegrasyonları için yapılandırma dosyasını bulun.

3. Sunucu kaydını aşağıdaki gibi ekleyin:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Kaydedin ve Claude’u yeniden başlatın.

5. Dosya Sistemi MCP Sunucusunun aktif olduğunu kontrol edin.

Cursor

1. Sunucu ikili dosyasını Go ile veya sürümden kurun.

2. Cursor’ın MCP için ayarlarını veya yapılandırma dosyasını açın.

3. Dosya Sistemi MCP Sunucusunu ekleyin:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Kaydedin ve Cursor’ı yeniden başlatın.

5. Bir test aracı (ör. list_directory) çalıştırarak entegrasyonu doğrulayın.

Cline

1. Dosya Sistemi MCP Sunucusu ikili dosyasını oluşturun veya indirin.

2. Cline’ın MCP entegrasyon ayarlarını yapılandırın.

3. Şunu ekleyin:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Cline’ı yeniden başlatın.

5. read_file işlemiyle test edin.

API Anahtarlarının Güvenliği Hakkında Not

Hassas veriler için ortam değişkenlerini kullanın. Örnek:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Bu MCP Akış İçinde Nasıl Kullanılır

FlowHunt’ta MCP kullanımı

MCP sunucusunu FlowHunt iş akışınıza entegre etmek için, akışınıza MCP bileşenini ekleyin ve onu AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümünde, MCP sunucu detaylarınızı şu JSON formatında girin:

{
  "filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanınız bu MCP’yi bir araç olarak kullanabilir ve tüm fonksiyonlarına erişim kazanır. “filesystem” adını, gerçek MCP sunucunuzun adıyla ve URL’yi kendi sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

| Kök Dizin Desteği | ✅ | list_allowed_directories ile izinli kökler gösterilir |

Bizim görüşümüz

Dosya Sistemi MCP Sunucusu, güvenli ve ayrıntılı dosya sistemi erişimine odaklanan sağlam bir çözümdür—dosya ve dizin işlemleri için kapsamlı MCP araçları sunar. Belgeleri nettir ve sunucu, yapay zekâ destekli geliştirme iş akışları için pratik yapıtaşları sağlar. Ancak, prompt şablonları veya açık MCP kaynakları belgelememiştir ve örnekleme gibi ileri MCP özelliklerinden bahsedilmemiştir. Kök dizin desteği, list_allowed_directories aracıyla sağlanmaktadır.

Puan: 8/10 — Mükemmel araç seti ve belgeleme, prompt/kaynak ve ileri MCP özelliklerinde küçük eksikler.

MCP Puanı