Blog

Hướng Dẫn Cài Đặt và Cấu Hình MongoDB MCP Server Chi Tiết

INEZA FELIN-MICHEL

INEZA FELIN-MICHEL

20 tháng 6 2025

Hướng Dẫn Cài Đặt và Cấu Hình MongoDB MCP Server Chi Tiết

Trong bối cảnh phát triển phần mềm không ngừng thay đổi, việc tích hợp Trí tuệ Nhân tạo (AI) không còn là một khái niệm tương lai mà đã trở thành hiện thực ngày nay. Các công cụ hỗ trợ AI đang nhanh chóng trở nên không thể thiếu đối với các nhà phát triển, giúp tinh giản quy trình làm việc và nâng cao năng suất. Nhận thấy xu hướng này, MongoDB đã giới thiệu một công cụ đột phá giúp kết nối cơ sở dữ liệu của bạn với AI: MongoDB Model Context Protocol (MCP) Server. Hướng dẫn này cung cấp một hướng dẫn toàn diện, từng bước để cài đặt và cấu hình MongoDB MCP Server, giúp bạn khai thác toàn bộ tiềm năng của AI trong môi trường phát triển của mình.

💡
Bạn muốn một công cụ Kiểm thử API tuyệt vời tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, All-in-One cho Nhóm Phát triển của mình làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi nhu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
button

MongoDB MCP Server là gì?

MongoDB MCP Server là một công cụ mới mạnh mẽ được thiết kế để kết nối các triển khai MongoDB của bạn với nhiều ứng dụng khách hỗ trợ AI khác nhau tuân theo Giao thức Ngữ cảnh Mô hình (Model Context Protocol - MCP). Dù bạn đang sử dụng MongoDB Atlas, cơ sở dữ liệu đám mây được quản lý hoàn toàn, hay phiên bản Cộng đồng (Community) hoặc Doanh nghiệp Nâng cao (Enterprise Advanced) tự lưu trữ, MCP Server đều cho phép tương tác liền mạch với dữ liệu của bạn bằng ngôn ngữ tự nhiên. Điều này có nghĩa là bạn có thể thực hiện nhiều loại thao tác cơ sở dữ liệu, từ các truy vấn dữ liệu đơn giản đến các tác vụ quản trị phức tạp, tất cả thông qua các lệnh hội thoại trực quan trong các công cụ phát triển AI yêu thích của bạn.

MCP là một tiêu chuẩn mở, ban đầu được giới thiệu bởi Anthropic, đang nhanh chóng trở nên phổ biến nhờ khả năng tạo ra một lớp giao tiếp chuẩn hóa giữa các tác nhân AI và các hệ thống dữ liệu đa dạng. Bằng cách triển khai giao thức này, MongoDB đảm bảo rằng người dùng của họ có thể đi đầu trong phát triển dựa trên AI. MCP Server tạo điều kiện cho một kênh giao tiếp hai chiều, cho phép bạn không chỉ truy vấn dữ liệu mà còn cung cấp cho các Mô hình Ngôn ngữ Lớn (LLM) của bạn thông tin cập nhật nhất và có ngữ cảnh liên quan từ cơ sở dữ liệu của bạn. Đây là một yếu tố thay đổi cuộc chơi cho các tác vụ như khám phá dữ liệu, quản trị cơ sở dữ liệu và tạo mã nhận biết ngữ cảnh.

MongoDB MCP Server hỗ trợ một hệ sinh thái đang phát triển của các ứng dụng khách MCP, bao gồm:

Hãy bắt đầu!

Điều kiện tiên quyết

Trước khi chúng ta đi sâu vào quá trình cài đặt, có một vài điều kiện tiên quyết bạn cần chuẩn bị:

Cài đặt và Cấu hình

Quá trình cài đặt và cấu hình MongoDB MCP Server hơi khác nhau tùy thuộc vào ứng dụng khách MCP bạn đang sử dụng. Cốt lõi của quá trình là thêm cấu hình JSON vào tệp cài đặt của ứng dụng khách, cho nó biết cách khởi chạy và giao tiếp với máy chủ MCP.

Lệnh chính để chạy máy chủ là npx -y mongodb-mcp-server. Cờ -y tự động xác nhận việc cài đặt gói nếu nó chưa có.

Thiết lập trong Cursor

Cursor là một trình soạn thảo mã AI-first đang nhanh chóng trở nên phổ biến. Dưới đây là cách bạn có thể thiết lập MongoDB MCP Server trong Cursor:

  1. Mở Cài đặt của Cursor: Khởi chạy Cursor và nhấp vào biểu tượng bánh răng ở góc trên bên phải cửa sổ để mở cài đặt.
  2. Điều hướng đến Phần MCP: Trong bảng cài đặt ở bên trái, nhấp vào "MCP".
  3. Thêm Máy chủ MCP Toàn cầu Mới: Nhấp vào nút "Add new global MCP server". Thao tác này sẽ mở một tệp cấu hình JSON.
  4. Nhập Cấu hình: Sao chép và dán cấu hình JSON sau vào tệp. Bạn sẽ cần tùy chỉnh thông tin này với chi tiết kết nối của mình.

<!-- end list -->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"
      }
    ]
  }
}

Nếu bạn đang sử dụng chuỗi kết nối thay vì thông tin xác thực API Atlas, cấu hình của bạn sẽ trông như thế này:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}
  1. Lưu Cấu hình: Lưu tệp. Cursor giờ đây sẽ có thể sử dụng MongoDB MCP Server mới của bạn.

Với máy chủ đã được cấu hình, giờ đây bạn có thể tương tác với cơ sở dữ liệu của mình bằng ngôn ngữ tự nhiên trong Cursor. Nếu bạn đã sử dụng thông tin xác thực API Atlas của mình, bạn sẽ có quyền truy cập vào một bộ công cụ phong phú dành riêng cho Atlas, cho phép bạn tạo các cụm miễn phí, quản lý danh sách truy cập, tạo người dùng cơ sở dữ liệu và nhiều hơn nữa. Nếu bạn đã sử dụng chuỗi kết nối, bạn sẽ có quyền truy cập vào các công cụ quản lý cơ sở dữ liệu, chẳng hạn như liệt kê các cơ sở dữ liệu và bộ sưu tập (collections), quản lý chỉ mục (indexes) và thực hiện các thao tác CRUD (Tạo, Đọc, Cập nhật, Xóa).

Thiết lập trong Claude Desktop

Nếu bạn là người dùng Claude của Anthropic, bạn có thể tích hợp MongoDB MCP Server trực tiếp vào ứng dụng máy tính để bàn Claude.

  1. Mở Tệp Cấu hình: Khởi động ứng dụng Claude Desktop, sau đó điều hướng đến Settings > Developer > Edit Config. Thao tác này sẽ mở tệp claude_desktop_config.json trong trình soạn thảo văn bản mặc định của bạn. Vị trí của tệp này thường là:
  1. Thêm Cấu hình Máy chủ MCP: Thêm cấu hình sau vào đối tượng mcpServers trong tệp JSON.

<!-- end list >JSON

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

Hãy chắc chắn thay thế chuỗi kết nối giữ chỗ bằng chuỗi kết nối thực tế của bạn.

  1. Khởi động lại Claude Desktop: Đóng và khởi động lại ứng dụng Claude Desktop.
  2. Xác minh Máy chủ: Nhấp vào biểu tượng cái búa trong Claude Desktop. MongoDB MCP Server giờ đây sẽ được liệt kê là một công cụ có sẵn.

Thiết lập trong Visual Studio Code với GitHub Copilot

Đối với hàng triệu nhà phát triển sử dụng Visual Studio Code, MongoDB MCP Server có thể được tích hợp với GitHub Copilot để mang tương tác cơ sở dữ liệu bằng ngôn ngữ tự nhiên đến với IDE yêu thích của bạn.

  1. Mở Command Palette: Mở VS Code và nhấn Ctrl+Shift+P (hoặc Cmd+Shift+P trên macOS) để mở command palette.
  2. Thêm Máy chủ MCP Mới: Gõ "mcp" vào command palette và chọn "MCP: Add Servers".
  3. Chọn Command Standard I/O: Chọn "Command Standard I/O" làm loại máy chủ.
  4. Nhập Lệnh: Nhập lệnh npx -y mongodb-mcp-server và đặt tên cho máy chủ của bạn, ví dụ: "mongodb".
  5. Cấu hình trong settings.json: Thao tác này sẽ mở tệp settings.json của bạn. Tại đây, bạn có thể thêm các đối số (arguments) và biến môi trường (environment variables) của mình. Ví dụ, để sử dụng chuỗi kết nối:

<!-- end list >JSON

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

Hoặc, để sử dụng thông tin xác thực API Atlas: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. Khởi động Máy chủ: Bạn có thể khởi động máy chủ bằng cách nhấp vào nút "Start" xuất hiện phía trên tên máy chủ trong tệp settings.json của bạn, hoặc bằng cách mở command palette, tìm kiếm "MCP: List Servers", chọn máy chủ của bạn, và sau đó chọn "Start Server".

Khi máy chủ đang chạy, bạn có thể sử dụng chế độ tác nhân (agent mode) của GitHub Copilot để tương tác với môi trường MongoDB Atlas của bạn. Bạn có thể yêu cầu nó liệt kê các dự án của bạn, tạo các cụm mới, quản lý người dùng, và nhiều hơn nữa, tất cả đều từ trong VS Code.

Cấu hình Nâng cao

MongoDB MCP Server cung cấp một số tùy chọn cấu hình nâng cao để điều chỉnh hành vi của nó theo nhu cầu cụ thể của bạn.

Chế độ Chỉ Đọc (Read-Only Mode)

Để tăng cường an toàn, đặc biệt khi kết nối với cơ sở dữ liệu sản xuất, bạn có thể chạy máy chủ ở chế độ chỉ đọc. Điều này sẽ ngăn chặn mọi thao tác ghi, chẳng hạn như tạo, cập nhật hoặc xóa tài liệu. Bạn có thể bật chế độ chỉ đọc bằng cách sử dụng đối số dòng lệnh:

npx mongodb-mcp-server --readOnly

Hoặc bằng cách đặt một biến môi trường:

export MDB_MCP_READ_ONLY=true

Vô hiệu hóa các Công cụ Cụ thể

Bạn có thể vô hiệu hóa các công cụ cụ thể để hạn chế khả năng của máy chủ. Điều này hữu ích cho mục đích bảo mật hoặc để đơn giản hóa các lệnh có sẵn. Bạn có thể vô hiệu hóa các công cụ bằng cách sử dụng đối số dòng lệnh --disabledTools, theo sau là danh sách các tên công cụ được phân tách bằng dấu cách.

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

Ngoài ra, bạn có thể sử dụng biến môi trường MDB_MCP_DISABLED_TOOLS với danh sách các tên công cụ được phân tách bằng dấu phẩy.

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

Đo lường từ xa (Telemetry)

Theo mặc định, MongoDB MCP Server thu thập dữ liệu sử dụng ẩn danh để giúp cải thiện sản phẩm. Nếu bạn muốn vô hiệu hóa điều này, bạn có thể sử dụng đối số dòng lệnh --telemetry disabled hoặc biến môi trường MDB_MCP_TELEMETRY=disabled.

Cài đặt Docker

Đối với những người thích môi trường container hóa, MongoDB MCP Server có thể được chạy trong một container Docker. Điều này cung cấp sự cô lập và loại bỏ nhu cầu cài đặt Node.js cục bộ.

Để chạy máy chủ với chuỗi kết nối:

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

Để chạy với thông tin xác thực API Atlas:

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

Sau đó, bạn sẽ cấu hình ứng dụng khách MCP của mình để sử dụng lệnh docker thay vì npx. Ví dụ, trong 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"
      ]
    }
  }
}

Kết luận

MongoDB MCP Server đại diện cho một bước tiến đáng kể trong việc tích hợp AI và cơ sở dữ liệu. Bằng cách cung cấp một cách chuẩn hóa để các ứng dụng khách AI tương tác với MongoDB, nó mở ra một thế giới khả năng cho các nhà phát triển. Từ truy vấn ngôn ngữ tự nhiên và khám phá dữ liệu đến quản trị cơ sở dữ liệu được hỗ trợ bởi AI và tạo mã, MCP Server được thiết lập để trở thành một công cụ thiết yếu trong bộ công cụ của nhà phát triển hiện đại.

Hướng dẫn này đã cung cấp một hướng dẫn toàn diện để bắt đầu với MongoDB MCP Server. Bằng cách làm theo các bước này, bạn có thể nhanh chóng và dễ dàng kết nối các triển khai MongoDB của mình với các công cụ AI yêu thích và bắt đầu gặt hái lợi ích của phát triển dựa trên AI. Vì đây là một công nghệ mới và đang phát triển, hãy đảm bảo kiểm tra tài liệu chính thức của MongoDB và kho lưu trữ GitHub để biết các bản cập nhật và tính năng mới nhất. Tương lai của tương tác cơ sở dữ liệu đã đến, và với MongoDB MCP Server, bạn đang ở tuyến đầu.

💡
Bạn muốn một công cụ Kiểm thử API tuyệt vời tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, All-in-One cho Nhóm Phát triển của mình làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi nhu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
button

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống