MongoDB MCP 서버 설치 및 설정 방법

소프트웨어 개발의 끊임없이 진화하는 환경에서 인공지능(AI)의 통합은 더 이상 미래의 개념이 아니라 현재의 현실입니다. AI 기반 도구는 개발자에게 빠르게 필수적인 존재가 되어 워크플로우를 간소화하고 생산성을 향상시키고 있습니다. 이러한 추세를 인식하여 MongoDB는 데이터베이스와 AI 사이의 격차를 해소하는 획기적인 도구인 MongoDB 모델 컨텍스트 프로토콜(MCP) 서버를 도입했습니다. 이 튜토리얼은 MongoDB MCP 서버를 설치하고 구성하는 방법에 대한 포괄적인 단계별 가이드를 제공하여 개발 환경에서 AI의 잠재력을 최대한 활용할 수 있도록 지원합니다.

💡

아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하십니까?

개발 팀이 최대의 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하십니까?

Apidog는 모든 요구 사항을 충족하며 Postman을 훨씬 저렴한 가격으로 대체합니다!

버튼

MongoDB MCP 서버란 무엇인가요?

MongoDB MCP 서버는 MongoDB 배포를 모델 컨텍스트 프로토콜(MCP)을 지원하는 다양한 AI 기반 클라이언트와 연결하도록 설계된 강력한 새 도구입니다. 완전 관리형 클라우드 데이터베이스인 MongoDB Atlas를 사용하든, 자체 호스팅된 커뮤니티 또는 엔터프라이즈 고급 버전을 사용하든, MCP 서버는 자연어를 사용하여 데이터와 원활하게 상호 작용할 수 있도록 합니다. 이는 좋아하는 AI 개발 도구 내에서 직관적인 대화형 명령을 통해 간단한 데이터 쿼리부터 복잡한 관리 작업에 이르기까지 광범위한 데이터베이스 작업을 수행할 수 있음을 의미합니다.

MCP는 Anthropic이 처음 도입한 개방형 표준으로, AI 에이전트와 다양한 데이터 시스템 간에 표준화된 통신 계층을 생성하는 능력으로 빠르게 주목받고 있습니다. 이 프로토콜을 구현함으로써 MongoDB는 사용자가 AI 기반 개발의 최전선에 머물 수 있도록 보장합니다. MCP 서버는 양방향 통신 채널을 촉진하여 데이터를 쿼리할 뿐만 아니라 데이터베이스에서 가장 최신이고 상황에 맞는 관련 정보를 대규모 언어 모델(LLM)에 제공할 수 있도록 합니다. 이는 데이터 탐색, 데이터베이스 관리, 컨텍스트 인식 코드 생성과 같은 작업에 있어 판도를 바꾸는 요소입니다.

MongoDB MCP 서버는 다음과 같은 성장하는 MCP 클라이언트 생태계를 지원합니다.

Windsurf: MCP 서버가 기본적으로 제공되는 AI 네이티브 코드 편집기입니다.
Cursor: 인기 있는 AI 기반 코드 편집기입니다.
Visual Studio Code의 GitHub Copilot: 데이터베이스의 기능을 세계에서 가장 인기 있는 IDE로 가져옵니다.
Anthropic의 Claude: Claude 데스크톱 애플리케이션에서 데이터베이스와 직접 상호 작용합니다.

시작해 보겠습니다!

전제 조건

설치 프로세스를 시작하기 전에 몇 가지 전제 조건이 필요합니다.

Node.js 및 npx: MongoDB MCP 서버는 Node.js 애플리케이션이며 일반적으로 Node.js 패키지 러너인 npx를 사용하여 설치 및 실행됩니다. 시스템에 Node.js 버전 18 이상이 설치되어 있어야 합니다. 터미널 또는 명령 프롬프트를 열고 node -v를 실행하여 Node.js 버전을 확인할 수 있습니다.
MongoDB 연결 문자열 또는 Atlas API 자격 증명: 데이터베이스에 연결하려면 MCP 서버에 표준 MongoDB 연결 문자열 또는 MongoDB Atlas 계정에 대한 API 자격 증명이 필요합니다.
연결 문자열: MongoDB 인스턴스에 연결하기 위한 표준 URI 형식입니다. 사용자 이름, 비밀번호, 호스트, 포트 및 데이터베이스 이름이 포함됩니다.
Atlas API 자격 증명: MongoDB Atlas를 사용하는 경우 필요한 권한을 가진 서비스 계정을 생성하고 생성된 API 클라이언트 ID 및 클라이언트 시크릿을 인증에 사용할 수 있습니다. 이 방법은 Atlas 관련 도구를 사용하는 데 필요합니다.
MCP 클라이언트: Cursor, Claude Desktop 또는 GitHub Copilot 확장 프로그램이 설치된 Visual Studio Code와 같이 지원되는 MCP 클라이언트 중 하나가 설치되어 있어야 합니다.
Docker (선택 사항): 컨테이너화된 환경에서 MCP 서버를 실행하려면 Docker 및 Docker Compose가 설치되어 있어야 합니다. 이는 로컬 샌드박스 테스트 및 로컬 Node.js 설치를 피하는 데 특히 유용합니다.

설치 및 구성

MongoDB MCP 서버의 설치 및 구성 프로세스는 사용 중인 MCP 클라이언트에 따라 약간 다릅니다. 프로세스의 핵심은 클라이언트의 설정 파일에 MCP 서버를 시작하고 통신하는 방법을 알려주는 JSON 구성을 추가하는 것입니다.

서버를 실행하는 기본 명령은 npx -y mongodb-mcp-server입니다. -y 플래그는 패키지가 아직 설치되지 않은 경우 설치를 자동으로 확인합니다.

Cursor에서 설정하기

Cursor는 빠르게 인기를 얻고 있는 AI 우선 코드 편집기입니다. Cursor에서 MongoDB MCP 서버를 설정하는 방법은 다음과 같습니다.

Cursor 설정 열기: Cursor를 실행하고 창 오른쪽 상단에 있는 톱니바퀴 아이콘을 클릭하여 설정을 엽니다.
MCP 섹션으로 이동: 왼쪽 설정 패널에서 "MCP"를 클릭합니다.
새 전역 MCP 서버 추가: "Add new global MCP server" 버튼을 클릭합니다. 그러면 JSON 구성 파일이 열립니다.
구성 입력: 다음 JSON 구성을 파일에 복사하여 붙여넣습니다. 연결 세부 정보로 이 부분을 사용자 지정해야 합니다.

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 자격 증명 대신 연결 문자열을 사용하는 경우 구성은 다음과 같습니다.JSON

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

구성 저장: 파일을 저장합니다. 이제 Cursor에서 새 MongoDB MCP 서버를 사용할 수 있습니다.

서버가 구성되면 이제 Cursor 내에서 자연어를 사용하여 데이터베이스와 상호 작용할 수 있습니다. Atlas API 자격 증명을 사용한 경우 무료 클러스터 생성, 액세스 목록 관리, 데이터베이스 사용자 생성 등 다양한 Atlas 관련 도구에 액세스할 수 있습니다. 연결 문자열을 사용한 경우 데이터베이스 및 컬렉션 나열, 인덱스 관리, CRUD(생성, 읽기, 업데이트, 삭제) 작업 수행과 같은 데이터베이스 관리 도구에 액세스할 수 있습니다.

Claude Desktop에서 설정하기

Anthropic의 Claude 사용자인 경우 MongoDB MCP 서버를 Claude 데스크톱 애플리케이션에 직접 통합할 수 있습니다.

구성 파일 열기: Claude Desktop 애플리케이션을 시작한 다음 Settings > Developer > Edit Config으로 이동합니다. 그러면 기본 텍스트 편집기에서 claude_desktop_config.json 파일이 열립니다. 이 파일의 위치는 일반적으로 다음과 같습니다.

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

MCP 서버 구성 추가: JSON 파일의 mcpServers 객체에 다음 구성을 추가합니다.

JSON

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

플레이스홀더 연결 문자열을 실제 연결 문자열로 바꿔야 합니다.

Claude Desktop 다시 시작: Claude Desktop 애플리케이션을 닫고 다시 시작합니다.
서버 확인: Claude Desktop에서 망치 아이콘을 클릭합니다. 이제 MongoDB MCP 서버가 사용 가능한 도구로 나열되어야 합니다.

GitHub Copilot과 함께 Visual Studio Code에서 설정하기

Visual Studio Code를 사용하는 수백만 명의 개발자를 위해 MongoDB MCP 서버는 GitHub Copilot과 통합되어 좋아하는 IDE에서 자연어 데이터베이스 상호 작용을 제공할 수 있습니다.

명령 팔레트 열기: VS Code를 열고 Ctrl+Shift+P(macOS에서는 Cmd+Shift+P)를 눌러 명령 팔레트를 엽니다.
새 MCP 서버 추가: 명령 팔레트에 "mcp"를 입력하고 "MCP: Add Servers"를 선택합니다.
Command Standard I/O 선택: 서버 유형으로 "Command Standard I/O"를 선택합니다.
명령 입력: npx -y mongodb-mcp-server 명령을 입력하고 서버 이름을 지정합니다. 예를 들어 "mongodb"로 지정합니다.
settings.json에서 구성: settings.json 파일이 열립니다. 여기에서 인수와 환경 변수를 추가할 수 있습니다. 예를 들어 연결 문자열을 사용하려면 다음과 같이 합니다.

JSON

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

또는 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"
      }
    }
  }
}

서버 시작: settings.json 파일에서 서버 이름 위에 나타나는 "Start" 버튼을 클릭하거나, 명령 팔레트를 열고 "MCP: List Servers"를 검색하여 서버를 선택한 다음 "Start Server"를 선택하여 서버를 시작할 수 있습니다.

서버가 실행되면 GitHub Copilot 에이전트 모드를 사용하여 MongoDB Atlas 환경과 상호 작용할 수 있습니다. VS Code 내에서 프로젝트 나열, 새 클러스터 생성, 사용자 관리 등을 요청할 수 있습니다.

고급 구성

MongoDB MCP 서버는 특정 요구 사항에 맞게 동작을 조정할 수 있는 몇 가지 고급 구성 옵션을 제공합니다.

읽기 전용 모드

특히 프로덕션 데이터베이스에 연결할 때 안전을 강화하기 위해 서버를 읽기 전용 모드로 실행할 수 있습니다. 이렇게 하면 문서 생성, 업데이트 또는 삭제와 같은 쓰기 작업이 방지됩니다. 명령줄 인수를 사용하여 읽기 전용 모드를 활성화할 수 있습니다.

npx mongodb-mcp-server --readOnly

또는 환경 변수를 설정하여 활성화할 수 있습니다.

export MDB_MCP_READ_ONLY=true

특정 도구 비활성화

서버의 기능을 제한하기 위해 특정 도구를 비활성화할 수 있습니다. 이는 보안 또는 사용 가능한 명령을 단순화하는 데 유용합니다. --disabledTools 명령줄 인수를 사용하고 그 뒤에 도구 이름을 공백으로 구분하여 나열하여 도구를 비활성화할 수 있습니다.

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

또는 쉼표로 구분된 도구 이름 목록과 함께 MDB_MCP_DISABLED_TOOLS 환경 변수를 사용할 수 있습니다.

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

원격 분석

기본적으로 MongoDB MCP 서버는 제품 개선에 도움이 되도록 익명의 사용 데이터를 수집합니다. 이를 비활성화하려면 --telemetry disabled 명령줄 인수 또는 MDB_MCP_TELEMETRY=disabled 환경 변수를 사용할 수 있습니다.

Docker 설치

컨테이너화된 환경을 선호하는 사용자를 위해 MongoDB MCP 서버는 Docker 컨테이너에서 실행될 수 있습니다. 이는 격리를 제공하고 로컬 Node.js 설치의 필요성을 없앱니다.

연결 문자열로 서버를 실행하려면:

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

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

그런 다음 MCP 클라이언트가 npx 대신 docker 명령을 사용하도록 구성합니다. 예를 들어 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"
      ]
    }
  }
}

결론

MongoDB MCP 서버는 AI와 데이터베이스 통합에 있어 중요한 진전을 나타냅니다. AI 클라이언트가 MongoDB와 상호 작용하는 표준화된 방법을 제공함으로써 개발자에게 무한한 가능성을 열어줍니다. 자연어 쿼리 및 데이터 탐색부터 AI 지원 데이터베이스 관리 및 코드 생성에 이르기까지 MCP 서버는 현대 개발자 도구 키트에서 필수적인 도구가 될 것입니다.

이 튜토리얼은 MongoDB MCP 서버 시작에 대한 포괄적인 가이드를 제공했습니다. 이 단계를 따르면 MongoDB 배포를 좋아하는 AI 도구에 빠르고 쉽게 연결하고 AI 기반 개발의 이점을 누릴 수 있습니다. 이는 새롭고 진화하는 기술이므로 최신 업데이트 및 기능을 위해 공식 MongoDB 문서와 GitHub 리포지토리를 확인하십시오. 데이터베이스 상호 작용의 미래가 여기에 있으며 MongoDB MCP 서버를 통해 여러분은 최첨단에 서 있습니다.

💡

버튼