Cara Install dan Konfigurasi MongoDB MCP Server

Dalam lanskap pengembangan perangkat lunak yang terus berkembang, integrasi Kecerdasan Buatan bukan lagi konsep futuristik tetapi realitas masa kini. Alat bertenaga AI dengan cepat menjadi sangat diperlukan bagi pengembang, merampingkan alur kerja, dan meningkatkan produktivitas. Menyadari tren ini, MongoDB telah memperkenalkan alat inovatif yang menjembatani kesenjangan antara basis data dan AI Anda: MongoDB Model Context Protocol (MCP) Server. Tutorial ini menyediakan panduan langkah demi langkah yang komprehensif untuk menginstal dan mengonfigurasi MongoDB MCP Server, memberdayakan Anda untuk memanfaatkan potensi penuh AI di lingkungan pengembangan Anda.

💡

Ingin alat Pengujian API yang hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform Terintegrasi, All-in-One untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!

button

Apa itu MongoDB MCP Server?

MongoDB MCP Server adalah alat baru yang canggih yang dirancang untuk menghubungkan deployment MongoDB Anda dengan berbagai klien bertenaga AI yang mendukung Model Context Protocol (MCP). Baik Anda menggunakan MongoDB Atlas, basis data cloud yang dikelola sepenuhnya, atau edisi Community atau Enterprise Advanced yang di-host sendiri, MCP Server memungkinkan interaksi yang mulus dengan data Anda menggunakan bahasa alami. Ini berarti Anda dapat melakukan berbagai operasi basis data, mulai dari kueri data sederhana hingga tugas administratif yang kompleks, semuanya melalui perintah percakapan yang intuitif dalam alat pengembangan AI favorit Anda.

MCP adalah standar terbuka, yang awalnya diperkenalkan oleh Anthropic, yang dengan cepat mendapatkan daya tarik karena kemampuannya untuk menciptakan lapisan komunikasi standar antara agen AI dan berbagai sistem data. Dengan mengimplementasikan protokol ini, MongoDB memastikan bahwa penggunanya dapat tetap berada di garis depan pengembangan berbasis AI. MCP Server memfasilitasi saluran komunikasi dua arah, memungkinkan Anda tidak hanya mengkueri data Anda tetapi juga menyediakan Model Bahasa Besar (LLM) Anda dengan informasi terbaru dan relevan secara kontekstual dari basis data Anda. Ini adalah pengubah permainan untuk tugas-tugas seperti eksplorasi data, administrasi basis data, dan pembuatan kode yang sadar konteks.

MongoDB MCP Server mendukung ekosistem klien MCP yang berkembang, termasuk:

Windsurf: Editor kode asli AI tempat server MCP tersedia secara langsung.
Cursor: Editor kode populer bertenaga AI.
GitHub Copilot di Visual Studio Code: Membawa kekuatan basis data Anda ke IDE paling populer di dunia.
Anthropic's Claude: Berinteraksi dengan basis data Anda langsung dari aplikasi desktop Claude.

Mari kita mulai!

Prasyarat

Sebelum kita masuk ke proses instalasi, ada beberapa prasyarat yang perlu Anda siapkan:

Node.js dan npx: MongoDB MCP Server adalah aplikasi Node.js dan biasanya diinstal dan dijalankan menggunakan npx, runner paket Node.js. Anda memerlukan Node.js versi 18 atau lebih tinggi yang terinstal di sistem Anda. Anda dapat memverifikasi versi Node.js Anda dengan membuka terminal atau command prompt dan menjalankan node -v.
String Koneksi MongoDB atau Kredensial Atlas API: Untuk terhubung ke basis data Anda, MCP Server memerlukan string koneksi MongoDB standar atau kredensial API untuk akun MongoDB Atlas Anda.
String Koneksi: Ini adalah format URI standar untuk terhubung ke instance MongoDB. Ini mencakup nama pengguna, kata sandi, host, port, dan nama basis data.
Kredensial Atlas API: Jika Anda menggunakan MongoDB Atlas, Anda dapat membuat akun layanan dengan izin yang diperlukan dan menggunakan ID Klien API dan Klien Rahasia yang dihasilkan untuk otentikasi. Metode ini diperlukan untuk menggunakan alat khusus Atlas.
Klien MCP: Anda memerlukan salah satu klien MCP yang didukung terinstal, seperti Cursor, Claude Desktop, atau Visual Studio Code dengan ekstensi GitHub Copilot.
Docker (Opsional): Jika Anda lebih suka menjalankan MCP Server di lingkungan bercontainer, Anda memerlukan Docker dan Docker Compose terinstal. Ini sangat berguna untuk pengujian sandbox lokal dan untuk menghindari instalasi Node.js lokal.

Instalasi dan Konfigurasi

Proses instalasi dan konfigurasi untuk MongoDB MCP Server sedikit bervariasi tergantung pada klien MCP yang Anda gunakan. Inti dari proses ini melibatkan penambahan konfigurasi JSON ke file pengaturan klien Anda yang memberitahunya cara meluncurkan dan berkomunikasi dengan server MCP.

Perintah utama untuk menjalankan server adalah npx -y mongodb-mcp-server. Flag -y secara otomatis mengonfirmasi instalasi paket jika belum ada.

Pengaturan di Cursor

Cursor adalah editor kode yang mengutamakan AI yang dengan cepat mendapatkan popularitas. Berikut cara Anda dapat menyiapkan MongoDB MCP Server di Cursor:

Buka Pengaturan Cursor: Luncurkan Cursor dan klik ikon roda gigi di sudut kanan atas jendela untuk membuka pengaturan.
Navigasi ke Bagian MCP: Di panel pengaturan di sebelah kiri, klik "MCP".
Tambahkan MCP Server Global Baru: Klik tombol "Add new global MCP server". Ini akan membuka file konfigurasi JSON.
Masukkan Konfigurasi: Salin dan tempel konfigurasi JSON berikut ke dalam file. Anda perlu menyesuaikannya dengan detail koneksi Anda.

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"
      }
    ]
  }
}

Jika Anda menggunakan string koneksi alih-alih kredensial Atlas API, konfigurasi Anda akan terlihat seperti ini:JSON

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

Simpan Konfigurasi: Simpan file. Cursor sekarang akan dapat menggunakan MongoDB MCP Server baru Anda.

Dengan server yang dikonfigurasi, Anda sekarang dapat berinteraksi dengan basis data Anda menggunakan bahasa alami di dalam Cursor. Jika Anda telah menggunakan kredensial Atlas API Anda, Anda akan memiliki akses ke serangkaian alat khusus Atlas yang kaya, memungkinkan Anda membuat cluster gratis, mengelola daftar akses, membuat pengguna basis data, dan banyak lagi. Jika Anda telah menggunakan string koneksi, Anda akan memiliki akses ke alat untuk manajemen basis data, seperti mencantumkan basis data dan koleksi, mengelola indeks, dan melakukan operasi CRUD (Create, Read, Update, Delete).

Pengaturan di Claude Desktop

Jika Anda adalah pengguna Claude dari Anthropic, Anda dapat mengintegrasikan MongoDB MCP Server langsung ke dalam aplikasi desktop Claude.

Buka File Konfigurasi: Mulai aplikasi Claude Desktop, lalu navigasikan ke Settings > Developer > Edit Config. Ini akan membuka file claude_desktop_config.json di editor teks default Anda. Lokasi file ini biasanya:

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

Tambahkan Konfigurasi MCP Server: Tambahkan konfigurasi berikut ke objek mcpServers dalam file JSON.

JSON

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

Pastikan untuk mengganti string koneksi placeholder dengan string koneksi Anda yang sebenarnya.

Mulai Ulang Claude Desktop: Tutup dan mulai ulang aplikasi Claude Desktop.
Verifikasi Server: Klik ikon palu di Claude Desktop. MongoDB MCP Server sekarang seharusnya terdaftar sebagai alat yang tersedia.

Pengaturan di Visual Studio Code dengan GitHub Copilot

Bagi jutaan pengembang yang menggunakan Visual Studio Code, MongoDB MCP Server dapat diintegrasikan dengan GitHub Copilot untuk membawa interaksi basis data bahasa alami ke IDE favorit Anda.

Buka Command Palette: Buka VS Code dan tekan Ctrl+Shift+P (atau Cmd+Shift+P di macOS) untuk membuka command palette.
Tambahkan MCP Server Baru: Ketik "mcp" ke dalam command palette dan pilih "MCP: Add Servers".
Pilih Command Standard I/O: Pilih "Command Standard I/O" sebagai tipe server.
Masukkan Perintah: Masukkan perintah npx -y mongodb-mcp-server dan berikan nama untuk server Anda, misalnya, "mongodb".
Konfigurasi di settings.json: Ini akan membuka file settings.json Anda. Di sini, Anda dapat menambahkan argumen dan variabel lingkungan Anda. Misalnya, untuk menggunakan string koneksi:

JSON

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

Atau, untuk menggunakan kredensial Atlas API: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"
      }
    }
  }
}

Mulai Server: Anda dapat memulai server dengan mengklik tombol "Start" yang muncul di atas nama server di file settings.json Anda, atau dengan membuka command palette, mencari "MCP: List Servers", memilih server Anda, lalu memilih "Start Server".

Setelah server berjalan, Anda dapat menggunakan mode agen GitHub Copilot untuk berinteraksi dengan lingkungan MongoDB Atlas Anda. Anda dapat memintanya untuk mencantumkan proyek Anda, membuat cluster baru, mengelola pengguna, dan banyak lagi, semuanya dari dalam VS Code.

Konfigurasi Lanjutan

MongoDB MCP Server menawarkan beberapa opsi konfigurasi lanjutan untuk menyesuaikan perilakunya dengan kebutuhan spesifik Anda.

Mode Hanya Baca (Read-Only Mode)

Untuk keamanan tambahan, terutama saat terhubung ke basis data produksi, Anda dapat menjalankan server dalam mode hanya baca. Ini akan mencegah operasi tulis apa pun, seperti membuat, memperbarui, atau menghapus dokumen. Anda dapat mengaktifkan mode hanya baca menggunakan argumen baris perintah:

npx mongodb-mcp-server --readOnly

Atau dengan mengatur variabel lingkungan:

export MDB_MCP_READ_ONLY=true

Menonaktifkan Alat Tertentu

Anda dapat menonaktifkan alat tertentu untuk membatasi kemampuan server. Ini berguna untuk keamanan atau untuk menyederhanakan perintah yang tersedia. Anda dapat menonaktifkan alat menggunakan argumen baris perintah --disabledTools, diikuti dengan daftar nama alat yang dipisahkan spasi.

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

Atau, Anda dapat menggunakan variabel lingkungan MDB_MCP_DISABLED_TOOLS dengan daftar nama alat yang dipisahkan koma.

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

Telemetri

Secara default, MongoDB MCP Server mengumpulkan data penggunaan anonim untuk membantu meningkatkan produk. Jika Anda ingin menonaktifkan ini, Anda dapat menggunakan argumen baris perintah --telemetry disabled atau variabel lingkungan MDB_MCP_TELEMETRY=disabled.

Instalasi Docker

Bagi mereka yang lebih suka lingkungan bercontainer, MongoDB MCP Server dapat dijalankan dalam container Docker. Ini menyediakan isolasi dan menghilangkan kebutuhan akan instalasi Node.js lokal.

Untuk menjalankan server dengan string koneksi:

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

Untuk menjalankan dengan kredensial Atlas API:

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

Anda kemudian akan mengonfigurasi klien MCP Anda untuk menggunakan perintah docker alih-alih npx. Misalnya, di Claude Desktop: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"
      ]
    }
  }
}

Kesimpulan

MongoDB MCP Server mewakili langkah maju yang signifikan dalam integrasi AI dan basis data. Dengan menyediakan cara standar bagi klien AI untuk berinteraksi dengan MongoDB, ini membuka dunia kemungkinan bagi pengembang. Mulai dari kueri bahasa alami dan eksplorasi data hingga administrasi basis data yang dibantu AI dan pembuatan kode, MCP Server siap menjadi alat penting dalam toolkit pengembang modern.

Tutorial ini telah menyediakan panduan komprehensif untuk memulai dengan MongoDB MCP Server. Dengan mengikuti langkah-langkah ini, Anda dapat dengan cepat dan mudah menghubungkan deployment MongoDB Anda ke alat AI favorit Anda dan mulai menuai manfaat pengembangan bertenaga AI. Karena ini adalah teknologi baru dan berkembang, pastikan untuk memeriksa dokumentasi resmi MongoDB dan repositori GitHub untuk pembaruan dan fitur terbaru. Masa depan interaksi basis data ada di sini, dan dengan MongoDB MCP Server, Anda berada di garis depan.

💡

button