MongoDB MCP Sunucusu Kurulumu ve Yapılandırması

Yazılım geliştirmenin sürekli gelişen ortamında, Yapay Zeka'nın entegrasyonu artık fütüristik bir konsept değil, günümüzün bir gerçeğidir. Yapay zeka destekli araçlar, geliştiriciler için hızla vazgeçilmez hale gelmekte, iş akışlarını düzene sokmakta ve üretkenliği artırmaktadır. Bu eğilimi fark eden MongoDB, veritabanınız ile yapay zeka arasındaki boşluğu kapatan çığır açan bir araç tanıttı: MongoDB Model Bağlam Protokolü (MCP) Sunucusu. Bu eğitim, MongoDB MCP Sunucusunu kurmak ve yapılandırmak için kapsamlı, adım adım bir kılavuz sunarak, geliştirme ortamınızda yapay zekanın tüm potansiyelinden yararlanmanızı sağlar.

MongoDB MCP Sunucusu Nedir?

MongoDB MCP Sunucusu, MongoDB dağıtımlarınızı Model Bağlam Protokolü (MCP) destekleyen çeşitli yapay zeka destekli istemcilere bağlamak için tasarlanmış güçlü yeni bir araçtır. İster tam olarak yönetilen bulut veritabanı olan MongoDB Atlas'ı, ister kendi barındırdığınız Community veya Enterprise Advanced sürümünü kullanıyor olun, MCP Sunucusu verilerinizle doğal dil kullanarak sorunsuz etkileşim sağlar. Bu, basit veri sorgularından karmaşık yönetim görevlerine kadar geniş bir yelpazedeki veritabanı işlemlerini, en sevdiğiniz yapay zeka geliştirme araçları içindeki sezgisel, konuşmaya dayalı komutlar aracılığıyla gerçekleştirebileceğiniz anlamına gelir.

MCP, başlangıçta Anthropic tarafından tanıtılan, yapay zeka ajanları ve çeşitli veri sistemleri arasında standartlaştırılmış bir iletişim katmanı oluşturma yeteneği sayesinde hızla popülerlik kazanan açık bir standarttır. Bu protokolü uygulayarak MongoDB, kullanıcılarının yapay zeka odaklı geliştirmenin ön saflarında kalmasını sağlamaktadır. MCP Sunucusu, verilerinizi sorgulamanın yanı sıra Büyük Dil Modellerinize (LLM) veritabanınızdan en güncel ve bağlamsal olarak ilgili bilgileri sağlamanıza olanak tanıyan iki yönlü bir iletişim kanalı kolaylaştırır. Bu, veri keşfi, veritabanı yönetimi ve bağlama duyarlı kod oluşturma gibi görevler için ezber bozan bir durumdur.

MongoDB MCP Sunucusu, aşağıdakiler dahil olmak üzere büyüyen bir MCP istemci ekosistemini desteklemektedir:

• Windsurf: MCP sunucusunun kutudan çıktığı gibi kullanıma sunulduğu yapay zeka yerlisi bir kod düzenleyici.
• Cursor: Popüler bir yapay zeka destekli kod düzenleyici.
• Visual Studio Code'da GitHub Copilot: Veritabanınızın gücünü dünyanın en popüler IDE'sine getiriyor.
• Anthropic'in Claude'u: Veritabanınızla doğrudan Claude masaüstü uygulamasından etkileşim kurun.

Başlayalım!

Ön Koşullar

Kurulum sürecine dalmadan önce yerine getirmeniz gereken birkaç ön koşul vardır:

• Node.js ve npx: MongoDB MCP Sunucusu bir Node.js uygulamasıdır ve genellikle Node.js paket çalıştırıcısı npx kullanılarak kurulur ve çalıştırılır. Sisteminizde Node.js sürüm 18 veya üzeri yüklü olmalıdır. Bir terminal veya komut istemi açıp node -v komutunu çalıştırarak Node.js sürümünüzü doğrulayabilirsiniz.
• MongoDB Bağlantı Dizisi veya Atlas API Kimlik Bilgileri: Veritabanınıza bağlanmak için MCP Sunucusunun standart bir MongoDB bağlantı dizisine veya MongoDB Atlas hesabınız için API kimlik bilgilerine ihtiyacı vardır.
• Bağlantı Dizisi: Bu, bir MongoDB örneğine bağlanmak için standart URI formatıdır. Kullanıcı adını, şifreyi, ana bilgisayarı, bağlantı noktasını ve veritabanı adını içerir.
• Atlas API Kimlik Bilgileri: MongoDB Atlas kullanıyorsanız, gerekli izinlere sahip bir hizmet hesabı oluşturabilir ve kimlik doğrulama için oluşturulan API İstemci Kimliği ve İstemci Gizli Anahtarını kullanabilirsiniz. Bu yöntem, Atlas'a özgü araçları kullanmak için gereklidir.
• Bir MCP İstemcisi: Cursor, Claude Desktop veya GitHub Copilot uzantılı Visual Studio Code gibi desteklenen MCP istemcilerinden birinin yüklü olması gerekir.
• Docker (İsteğe Bağlı): MCP Sunucusunu kapsayıcılı bir ortamda çalıştırmayı tercih ediyorsanız, Docker ve Docker Compose yüklü olmalıdır. Bu, özellikle yerel sandbox testleri ve yerel Node.js kurulumundan kaçınmak için kullanışlıdır.

Kurulum ve Yapılandırma

MongoDB MCP Sunucusunun kurulum ve yapılandırma süreci, kullandığınız MCP istemcisine bağlı olarak biraz değişir. Sürecin özü, istemcinizin ayarlar dosyasına, MCP sunucusunu nasıl başlatacağını ve onunla nasıl iletişim kuracağını bildiren bir JSON yapılandırması eklemeyi içerir.

Sunucuyu çalıştırmak için birincil komut npx -y mongodb-mcp-server'dır. -y bayrağı, paket zaten mevcut değilse kurulumu otomatik olarak onaylar.

Cursor'da Kurulum

Cursor, hızla popülerlik kazanan, yapay zeka öncelikli bir kod düzenleyicisidir. MongoDB MCP Sunucusunu Cursor'da nasıl kurabileceğiniz aşağıda açıklanmıştır:

1. Cursor Ayarlarını Açın: Cursor'ı başlatın ve ayarları açmak için pencerenin sağ üst köşesindeki dişli simgesine tıklayın.
2. MCP Bölümüne Gidin: Soldaki ayarlar panelinde "MCP"ye tıklayın.
3. Yeni Bir Genel MCP Sunucusu Ekleyin: "Yeni genel MCP sunucusu ekle" düğmesine tıklayın. Bu, bir JSON yapılandırma dosyası açacaktır.
4. Yapılandırmayı Girin: Aşağıdaki JSON yapılandırmasını kopyalayıp dosyaya yapıştırın. Bunu bağlantı ayrıntılarınızla özelleştirmeniz gerekecektir.

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Atlas API kimlik bilgileri yerine bir bağlantı dizisi kullanıyorsanız, yapılandırmanız şöyle görünecektir:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

1. Yapılandırmayı Kaydedin: Dosyayı kaydedin. Cursor artık yeni MongoDB MCP Sunucunuzu kullanabilecektir.

Sunucu yapılandırıldıktan sonra, Cursor içinde doğal dil kullanarak veritabanınızla etkileşim kurabilirsiniz. Atlas API kimlik bilgilerinizi kullandıysanız, ücretsiz kümeler oluşturmanıza, erişim listelerini yönetmenize, veritabanı kullanıcıları oluşturmanıza ve çok daha fazlasına olanak tanıyan zengin bir Atlas'a özgü araç setine erişiminiz olacaktır. Bir bağlantı dizisi kullandıysanız, veritabanlarını ve koleksiyonları listeleme, dizinleri yönetme ve CRUD (Oluşturma, Okuma, Güncelleme, Silme) işlemleri gerçekleştirme gibi veritabanı yönetimi araçlarına erişiminiz olacaktır.

Claude Desktop'ta Kurulum

Anthropic'in Claude'unu kullanıyorsanız, MongoDB MCP Sunucusunu doğrudan Claude masaüstü uygulamasına entegre edebilirsiniz.

1. Yapılandırma Dosyasını Açın: Claude Desktop uygulamasını başlatın, ardından Ayarlar > Geliştirici > Yapılandırmayı Düzenle'ye gidin. Bu, varsayılan metin düzenleyicinizde claude_desktop_config.json dosyasını açacaktır. Bu dosyanın konumu genellikle şöyledir:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

1. MCP Sunucu Yapılandırmasını Ekleyin: JSON dosyasındaki mcpServers nesnesine aşağıdaki yapılandırmayı ekleyin.

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

Yer tutucu bağlantı dizisini gerçek bağlantı dizinizle değiştirdiğinizden emin olun.

1. Claude Desktop'u Yeniden Başlatın: Claude Desktop uygulamasını kapatın ve yeniden başlatın.
2. Sunucuyu Doğrulayın: Claude Desktop'ta çekiç simgesine tıklayın. MongoDB MCP Sunucusu artık kullanılabilir bir araç olarak listelenmelidir.

Visual Studio Code'da GitHub Copilot ile Kurulum

Visual Studio Code kullanan milyonlarca geliştirici için, MongoDB MCP Sunucusu GitHub Copilot ile entegre edilerek en sevdiğiniz IDE'ye doğal dil veritabanı etkileşimi getirilebilir.

1. Komut Paletini Açın: VS Code'u açın ve komut paletini açmak için Ctrl+Shift+P (veya macOS'ta Cmd+Shift+P) tuşlarına basın.
2. Yeni Bir MCP Sunucusu Ekleyin: Komut paletine "mcp" yazın ve "MCP: Sunucuları Ekle"yi seçin.
3. Komut Standart G/Ç'yi Seçin: Sunucu türü olarak "Komut Standart G/Ç"yi seçin.
4. Komutu Girin: npx -y mongodb-mcp-server komutunu girin ve sunucunuza bir ad verin, örneğin "mongodb".
5. settings.json'da Yapılandırın: Bu, settings.json dosyanızı açacaktır. Burada argümanlarınızı ve ortam değişkenlerinizi ekleyebilirsiniz. Örneğin, bir bağlantı dizisi kullanmak için:

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Veya Atlas API kimlik bilgilerini kullanmak için:JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

1. Sunucuyu Başlatın: Sunucuyu, settings.json dosyanızda sunucu adının üzerinde görünen "Başlat" düğmesine tıklayarak veya komut paletini açıp "MCP: Sunucuları Listele"yi arayarak, sunucunuzu seçip ardından "Sunucuyu Başlat"ı seçerek başlatabilirsiniz.

Sunucu çalıştıktan sonra, MongoDB Atlas ortamınızla etkileşim kurmak için GitHub Copilot ajan modunu kullanabilirsiniz. VS Code içinden projelerinizi listelemesini, yeni kümeler oluşturmasını, kullanıcıları yönetmesini ve çok daha fazlasını isteyebilirsiniz.

Gelişmiş Yapılandırma

MongoDB MCP Sunucusu, davranışını özel ihtiyaçlarınıza göre uyarlamak için çeşitli gelişmiş yapılandırma seçenekleri sunar.

Salt Okunur Mod

Ek güvenlik için, özellikle üretim veritabanlarına bağlanırken, sunucuyu salt okunur modda çalıştırabilirsiniz. Bu, belge oluşturma, güncelleme veya silme gibi herhangi bir yazma işlemini önleyecektir. Salt okunur modu bir komut satırı argümanı kullanarak etkinleştirebilirsiniz:

npx mongodb-mcp-server --readOnly

Veya bir ortam değişkeni ayarlayarak:

export MDB_MCP_READ_ONLY=true

Belirli Araçları Devre Dışı Bırakma

Sunucunun yeteneklerini kısıtlamak için belirli araçları devre dışı bırakabilirsiniz. Bu, güvenlik veya mevcut komutları basitleştirmek için kullanışlıdır. Araçları, boşlukla ayrılmış araç adları listesiyle birlikte --disabledTools komut satırı argümanını kullanarak devre dışı bırakabilirsiniz.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

Alternatif olarak, virgülle ayrılmış araç adları listesiyle MDB_MCP_DISABLED_TOOLS ortam değişkenini kullanabilirsiniz.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

Telemetri

Varsayılan olarak, MongoDB MCP Sunucusu ürünü iyileştirmeye yardımcı olmak için anonim kullanım verileri toplar. Bunu devre dışı bırakmak isterseniz, --telemetry disabled komut satırı argümanını veya MDB_MCP_TELEMETRY=disabled ortam değişkenini kullanabilirsiniz.

Docker Kurulumu

Kapsayıcılı bir ortamı tercih edenler için, MongoDB MCP Sunucusu bir Docker kapsayıcısında çalıştırılabilir. Bu, izolasyon sağlar ve yerel bir Node.js kurulumuna olan ihtiyacı ortadan kaldırır.

Sunucuyu bir bağlantı dizisiyle çalıştırmak için:

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

Atlas API kimlik bilgileriyle çalıştırmak için:

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

Daha sonra MCP istemcinizi npx yerine docker komutunu kullanacak şekilde yapılandırırsınız. Örneğin, Claude Desktop'ta:JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Sonuç

MongoDB MCP Sunucusu, yapay zeka ve veritabanlarının entegrasyonunda önemli bir adım ileriye gitmektedir. Yapay zeka istemcilerinin MongoDB ile etkileşim kurması için standartlaştırılmış bir yol sağlayarak, geliştiriciler için bir dünya olasılık açmaktadır. Doğal dil sorgulama ve veri keşfinden, yapay zeka destekli veritabanı yönetimi ve kod oluşturmaya kadar, MCP Sunucusu modern geliştiricinin araç setinde vazgeçilmez bir araç olmaya adaydır.

Bu eğitim, MongoDB MCP Sunucusuna başlamak için kapsamlı bir kılavuz sunmuştur. Bu adımları izleyerek, MongoDB dağıtımlarınızı en sevdiğiniz yapay zeka araçlarına hızlı ve kolay bir şekilde bağlayabilir ve yapay zeka destekli geliştirmenin faydalarından yararlanmaya başlayabilirsiniz. Bu yeni ve gelişmekte olan bir teknoloji olduğundan, en son güncellemeler ve özellikler için resmi MongoDB belgelerini ve GitHub deposunu kontrol ettiğinizden emin olun. Veritabanı etkileşiminin geleceği burada ve MongoDB MCP Sunucusu ile en ileri noktadasınız.