MongoDB Mongoose MCP Sunucusu

“MongoDB Mongoose” MCP Sunucusu ne yapar?

MongoDB Mongoose MCP Sunucusu, AI asistanlarının (ör. Claude gibi) doğrudan MongoDB veritabanlarıyla etkileşime girmesini sağlayan bir Model Context Protocol (MCP) sunucusudur. İsteğe bağlı Mongoose şeması desteği ile güçlü veri doğrulama ve operasyonel kancalar sağlar. Bu sunucu, AI tabanlı iş akışlarının sorgulama, toplama, ekleme, güncelleme ve MongoDB koleksiyonlarının yönetimi dahil çok çeşitli veritabanı görevlerini yerine getirmesini sağlar. Tasarımı, hem şemalı hem de şemasız işlemleri destekleyerek farklı geliştirme ortamlarına esneklik kazandırır. Veritabanı eylemlerini birer araç olarak sunarak MongoDB Mongoose MCP, geliştirici verimliliğini artırır, veri yönetimini kolaylaştırır ve kritik veri altyapısına güvenli, doğal dil tabanlı erişim imkanı verir.

İstem Listesi

Depoda veya dökümantasyonda açık bir istem şablonu bulunmamaktadır.

Kaynak Listesi

Belgelendirmede veya depo dosyalarında açık bir MCP kaynağı belirtilmemiştir.

Sorgu Araçları

• find: Belgeleri filtreleme ve projeksiyon ile sorgular.
• listCollections: Veritabanındaki tüm koleksiyonları listeler.
• insertOne: Bir koleksiyona tek bir belge ekler.
• updateOne: Bir koleksiyonda tek bir belgeyi günceller.
• deleteOne: Tek bir belgeyi yumuşak siler (sadece silindi olarak işaretler, kaldırmaz).
• count: Bir filtreyle eşleşen belge sayısını verir.
• aggregate: Pipeline kullanarak toplama sorguları çalıştırır.

İndeks Araçları

• createIndex: Bir koleksiyonda yeni bir indeks oluşturur.
• dropIndex: Bir koleksiyondan indeks kaldırır.
• indexes: Belirli bir koleksiyonun tüm indekslerini listeler.

Bu MCP Sunucusunun Kullanım Senaryoları

• Veritabanı Yönetimi: AI istemcilerinin CRUD işlemleri yapmasını, indeksleri yönetmesini ve verileri güvenli şekilde doğal dil ile sorgulamasını sağlar; manuel veritabanı erişimi ihtiyacını azaltır.
• Veri Keşfi: Geliştiricilerin MongoDB koleksiyonlarını keşfetmesini, toplama pipeline’ları çalıştırmasını ve etkileşimli şekilde içgörü üretmesini sağlar.
• Şema Uygulaması: Mongoose entegrasyonu ile geliştiriciler veri doğrulamasını zorunlu kılabilir ve daha temiz veri yönetimi için kancalardan yararlanabilir.
• Yumuşak Silme İş Akışları: Yumuşak silme desenlerini destekler; veriler kaybolmaz, silindi olarak işaretlenir ve gerekirse geri alınabilir.
• Hızlı Prototipleme: AI asistanı üzerinden doğrudan manuel betik yazmadan şema değişikliklerinin ve veri modellerinin hızlıca test edilmesine imkan tanır.

Kurulumu Nasıl Yapılır

Windsurf

1. Node.js (v18+) ve MongoDB’nin kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyanızı bulun ve düzenleyin.
3. mcpServers bölümüne MongoDB Mongoose MCP sunucusunu ekleyin:

   {
     "mcpServers": {
       "mongodb-mongoose": {
         "command": "npx",
         "args": [
           "-y",
           "mongo-mongoose-mcp"
         ],
         "env": {
           "MONGODB_URI": "<your mongodb uri>",
           "SCHEMA_PATH": "<path to the root folder of your mongoose schema objects>"
         }
       }
     }
   }
   

4. Dosyayı kaydedin ve Windsurf’u yeniden başlatın.
5. MCP sunucusunun çalıştığını ve erişilebilir olduğunu doğrulayın.

Claude

1. Claude Masaüstü Ayarları > Geliştirici > Yapılandırmayı Düzenle bölümünü açın.
2. claude_desktop_config.json dosyanıza MongoDB Mongoose MCP sunucusunu ekleyin:

   {
     "mcpServers": {
       "mongodb-mongoose": {
         "command": "npx",
         "args": [
           "-y",
           "mongo-mongoose-mcp"
         ],
         "env": {
           "MONGODB_URI": "<your mongodb uri>",
           "SCHEMA_PATH": "<path to the root folder of your mongoose schema objects>"
         }
       }
     }
   }
   

3. Yapılandırmayı kaydedin ve Claude Masaüstü’nü yeniden başlatın.
4. Bir veritabanı komutu göndererek entegrasyonu doğrulayın.

Cursor

1. Node.js (v18+) ve MongoDB’yi yükleyin.
2. Cursor’ın yapılandırma arayüzünü açın.
3. MCP Sunucuları altına şu JSON’u ekleyin:

   {
     "mcpServers": {
       "mongodb-mongoose": {
         "command": "npx",
         "args": [
           "-y",
           "mongo-mongoose-mcp"
         ],
         "env": {
           "MONGODB_URI": "<your mongodb uri>",
           "SCHEMA_PATH": "<path to mongoose schemas>"
         }
       }
     }
   }
   

4. Kaydedin ve Cursor’u tekrar yükleyin.
5. Cursor üzerinden bir veritabanı sorgusu çalıştırarak test edin.

Cline

1. Gereksinimler: Node.js (v18+) ve MongoDB’nin kurulu olduğundan emin olun.
2. Cline yapılandırma dosyanızı düzenleyin.
3. Şunları ekleyin:

   {
     "mcpServers": {
       "mongodb-mongoose": {
         "command": "npx",
         "args": [
           "-y",
           "mongo-mongoose-mcp"
         ],
         "env": {
           "MONGODB_URI": "<your mongodb uri>",
           "SCHEMA_PATH": "<path to mongoose schemas>"
         }
       }
     }
   }
   

4. Dosyayı kaydedin ve Cline’ı yeniden başlatın.
5. Desteklenen bir komut göndererek sunucunun çalıştığını doğrulayın.

API Anahtarlarını Güvenceye Almak

Her zaman MONGODB_URI gibi hassas verileri ortam değişkenlerinde saklayın. Örnek yapılandırma:

{
  "mcpServers": {
    "mongodb-mongoose": {
      "command": "npx",
      "args": [
        "-y",
        "mongo-mongoose-mcp"
      ],
      "env": {
        "MONGODB_URI": "${MONGODB_URI}",
        "SCHEMA_PATH": "${SCHEMA_PATH}"
      },
      "inputs": {
        "MONGODB_URI": "ortamda ayarlı",
        "SCHEMA_PATH": "ortamda ayarlı"
      }
    }
  }
}

Bu MCP’yi FlowHunt İş Akışlarında Kullanmak

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, MCP bileşenini akışınıza ekleyin ve 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üne, MCP sunucu ayrıntılarınızı şu JSON formatında girin:

{
  "mongodb-mongoose": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma sonrası, AI ajanı artık bu MCP’nin tüm işlev ve kabiliyetlerine araç olarak erişebilir. “mongodb-mongoose” adını kendi MCP sunucu adınızla, URL’i ise kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Roots desteği: ⛔ (Dökümantasyonda/depo’da bilgi yok)

İki tablo arasında, bu MCP sunucu uygulaması veritabanı araçları ve kurulum dökümantasyonu açısından sağlamdır; ancak istemler, açık kaynaklar, roots ve örnekleme desteği hakkında bilgi eksiktir. İşlevsel açıdan güçlüdür fakat daha gelişmiş MCP kavramları için tam kapsamlı değildir.

Bizim Görüşümüz

MCP Skoru: 6/10
MongoDB Mongoose MCP, kurulum ve araç kullanımı açısından iyi belgelenmiş ve veritabanı operasyonlarına odaklanan geliştiriciler için pratik bir çözümdür. Ancak istem şablonları, açık kaynaklar, roots ve örnekleme özelliklerinin eksikliği, gelişmiş MCP iş akışları için tamamlayıcılığını sınırlar.

MCP Skoru