MongoDB MCP 서버

MongoDB 데이터베이스 및 MongoDB Atlas와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버입니다.

📚 목차

필수 조건

Node.js(v20.10.0 이상)

지엑스피1

MongoDB 연결 문자열이나 Atlas API 자격 증명이 구성되지 않으면 서버가 시작되지 않습니다 .
- 서비스 계정 Atlas API 자격 증명은 Atlas 도구를 사용하는 데 필요합니다. MongoDB Atlas에서 서비스 계정을 생성하고 해당 자격 증명을 사용하여 인증할 수 있습니다. 자세한 내용은 Atlas API 액세스를 참조하세요.
- MongoDB 연결 문자열이 있으면 이를 사용하여 MongoDB 인스턴스에 직접 연결할 수 있습니다.

설정

빠른 시작

대부분의 MCP 클라이언트는 MCP 서버를 추가하기 위해 구성 파일을 만들거나 수정해야 합니다.

참고: 구성 파일 구문은 클라이언트마다 다를 수 있습니다. 최신 예상 구문은 다음 링크를 참조하세요.

윈드서핑 : https://docs.windsurf.com/windsurf/mcp
VSCode : https://code.visualstudio.com/docs/copilot/chat/mcp-servers
클로드 데스크톱 : https://modelcontextprotocol.io/quickstart/user
커서 : https://docs.cursor.com/context/model-context-protocol

옵션 1: 연결 문자열 인수

인수를 통해 연결 문자열을 전달할 수 있으며, 유효한 사용자 이름과 비밀번호를 사용해야 합니다.

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb://localhost:27017/myDatabase"
      ]
    }
  }
}

참고: 연결 문자열은 로컬 인스턴스든 Atlas 클러스터든 모든 MongoDB 클러스터에 연결하도록 구성할 수 있습니다.

옵션 2: Atlas API 자격 증명 인수

Atlas API 서비스 계정 자격 증명을 사용하세요. Atlas API 액세스 섹션의 모든 단계를 따라야 합니다.

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--apiClientId",
        "your-atlas-service-accounts-client-id",
        "--apiClientSecret",
        "your-atlas-service-accounts-client-secret"
      ]
    }
  }
}

옵션 3: 명령 인수를 사용하는 독립 실행형 서비스

npx 명령을 사용하여 서버를 시작합니다.

 npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret"

인수의 전체 목록은 구성 옵션을 참조하세요.
Atlas 서비스 계정 자격 증명을 구성하려면 Atlas API 액세스 를 참조하세요.

옵션 4: 환경 변수를 사용하는 독립 실행형 서비스

 npx -y mongodb-mcp-server

구성 파일에서 환경 변수를 사용하거나 환경 변수를 설정하고 npx를 통해 서버를 실행할 수 있습니다.

MCP 파일 예제 에서 환경 변수를 통한 연결 문자열
MCP 파일 예제 의 환경 변수를 통한 Atlas API 자격 증명

🛠️ 지원 도구

도구 목록

MongoDB Atlas 도구

atlas-list-orgs - MongoDB Atlas 조직 목록
atlas-list-projects - MongoDB Atlas 프로젝트 목록
atlas-create-project - 새로운 MongoDB Atlas 프로젝트를 생성합니다.
atlas-list-clusters - MongoDB Atlas 클러스터 목록
atlas-inspect-cluster - 특정 MongoDB Atlas 클러스터 검사
atlas-create-free-cluster - 무료 MongoDB Atlas 클러스터 만들기
atlas-connect-cluster - MongoDB Atlas 클러스터에 연결합니다.
atlas-inspect-access-list - MongoDB Atlas 클러스터에 액세스하여 IP/CIDR 범위를 검사합니다.
atlas-create-access-list - MongoDB Atlas 클러스터에 대한 IP/CIDR 액세스 목록 구성
atlas-list-db-users - MongoDB Atlas 데이터베이스 사용자 목록
atlas-create-db-user - MongoDB Atlas 데이터베이스 사용자를 생성합니다.
atlas-list-alerts - 프로젝트에 대한 MongoDB Atlas 알림 목록

참고: Atlas 도구는 구성 섹션에서 자격 증명을 설정한 경우에만 사용할 수 있습니다.

MongoDB 데이터베이스 도구

connect - MongoDB 인스턴스에 연결
find - MongoDB 컬렉션에 대해 find 쿼리를 실행합니다.
aggregate - MongoDB 컬렉션에 대한 집계 실행
count - MongoDB 컬렉션에 있는 문서 수를 가져옵니다.
insert-one - MongoDB 컬렉션에 단일 문서 삽입
insert-many - MongoDB 컬렉션에 여러 문서 삽입
create-index - MongoDB 컬렉션에 대한 인덱스를 생성합니다.
update-one - MongoDB 컬렉션의 단일 문서 업데이트
update-many - MongoDB 컬렉션의 여러 문서 업데이트
rename-collection - MongoDB 컬렉션 이름 바꾸기
delete-one - MongoDB 컬렉션에서 단일 문서 삭제
delete-many - MongoDB 컬렉션에서 여러 문서 삭제
drop-collection - MongoDB 데이터베이스에서 컬렉션 제거
drop-database - MongoDB 데이터베이스 제거
list-databases - MongoDB 연결에 대한 모든 데이터베이스 나열
list-collections - 주어진 데이터베이스에 대한 모든 컬렉션을 나열합니다.
collection-indexes - 컬렉션의 인덱스를 설명합니다.
collection-schema - 컬렉션의 스키마를 설명합니다.
collection-storage-size - 컬렉션 크기를 MB 단위로 가져옵니다.
db-stats - MongoDB 데이터베이스에 대한 통계를 반환합니다.

구성

MongoDB MCP 서버는 여러 가지 방법을 사용하여 구성할 수 있으며, 우선순위는 다음과 같습니다(가장 높은 것부터 가장 낮은 것까지):

명령줄 인수
환경 변수

구성 옵션

옵션	설명
`apiClientId`	인증을 위한 Atlas API 클라이언트 ID
`apiClientSecret`	인증을 위한 Atlas API 클라이언트 비밀번호
`connectionString`	직접 데이터베이스 연결을 위한 MongoDB 연결 문자열(선택 사항 사용자는 모든 도구 호출 시 이를 알리도록 선택할 수 있음)
`logPath`	로그를 저장할 폴더
`disabledTools`	비활성화될 도구 이름, 작업 유형 및/또는 도구 범주의 배열
`readOnly`	true로 설정하면 읽기 및 메타데이터 작업 유형만 허용되고 생성/업데이트/삭제 작업은 비활성화됩니다.
`telemetry`	비활성화로 설정하면 원격 측정 수집이 비활성화됩니다.

로그 경로

기본 로그 위치는 다음과 같습니다.

윈도우: %LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs
macOS/Linux: ~/.mongodb/mongodb-mcp/.app-logs

장애인 도구

disabledTools 옵션을 사용하여 특정 도구 또는 도구 범주를 비활성화할 수 있습니다. 이 옵션은 문자열 배열을 허용하며, 각 문자열은 도구 이름, 작업 유형 또는 범주일 수 있습니다.

배열이 구성되는 방식은 사용하는 구성 방법의 유형에 따라 달라집니다.

환경 변수 를 구성하려면 쉼표로 구분된 문자열을 사용하세요: export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema" .
명령줄 인수 구성의 경우 공백으로 구분된 문자열을 사용하세요: --disabledTools create update delete atlas collectionSchema .

도구의 종류:

atlas - MongoDB Atlas 도구(클러스터 목록, 클러스터 생성 등)
mongodb - 찾기, 집계 등의 MongoDB 데이터베이스 도구

작업 유형:

create - 클러스터 생성, 문서 삽입 등과 같이 리소스를 생성하는 도구입니다.
update - 문서 업데이트, 컬렉션 이름 변경 등 리소스를 업데이트하는 도구입니다.
delete - 문서 삭제, 컬렉션 삭제 등 리소스를 삭제하는 도구입니다.
read - 찾기, 집계, 클러스터 나열 등과 같이 리소스를 읽는 도구입니다.
metadata - 목록 데이터베이스, 목록 컬렉션, 컬렉션 스키마 등과 같은 메타데이터를 읽는 도구입니다.

읽기 전용 모드

readOnly 구성 옵션을 사용하면 MCP 서버가 "읽기" 및 "메타데이터" 작업 유형을 가진 도구만 사용하도록 제한할 수 있습니다. 이 옵션을 활성화하면 "생성", "업데이트" 또는 "삭제" 작업 유형을 가진 모든 도구가 서버에 등록되지 않습니다.

이 기능은 데이터나 인프라를 수정하지 않고도 분석을 위해 MongoDB 데이터에 대한 액세스를 제공하려는 경우에 유용합니다.

다음을 사용하여 읽기 전용 모드를 활성화할 수 있습니다.

환경 변수 : export MDB_MCP_READ_ONLY=true
명령줄 인수 : --readOnly

읽기 전용 모드가 활성화되어 있으면 이 제한으로 인해 어떤 도구가 등록되지 않았는지 알려주는 메시지가 서버 로그에 표시됩니다.

원격 측정

telemetry 구성 옵션을 사용하면 원격 측정 데이터 수집을 비활성화할 수 있습니다. 활성화하면 MCP 서버가 사용 데이터를 수집하여 MongoDB로 전송합니다.

다음을 사용하여 원격 측정을 비활성화할 수 있습니다.

환경 변수 : export MDB_MCP_TELEMETRY=disabled
명령줄 인수 : --telemetry disabled
DO_NOT_TRACK 환경 변수 : export DO_NOT_TRACK=1

Atlas API 액세스

Atlas API 도구를 사용하려면 MongoDB Atlas에 서비스 계정을 만들어야 합니다.

서비스 계정 만들기:
- cloud.mongodb.com 에서 MongoDB Atlas에 로그인하세요.
- 액세스 관리자 > 조직 액세스로 이동합니다.
- 새로 추가 > 애플리케이션 > 서비스 계정을 클릭합니다.
- 서비스 계정의 이름, 설명 및 만료일을 입력하세요(예: "MCP, MCP 서버 액세스, 7일").
- 적절한 권한을 선택하세요(전체 액세스의 경우 조직 소유자 사용)
- "만들기"를 클릭하세요

서비스 계정에 대해 자세히 알아보려면 MongoDB Atlas 문서를 확인하세요.

클라이언트 자격 증명 저장:
- 생성 후 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 중요: 클라이언트 비밀번호는 다시 표시되지 않으므로 즉시 복사하여 저장하세요.
액세스 목록 항목 추가:
- API 액세스 목록에 IP 주소를 추가하세요
MCP 서버 구성:
- 아래 구성 방법 중 하나를 사용하여 apiClientId 및 apiClientSecret 설정하세요.

구성 방법

환경 변수

대문자로 옵션 이름을 붙이고 MDB_MCP_ 접두사를 붙여 환경 변수를 설정합니다. 뒤에 밑줄을 붙입니다.

# Set Atlas API credentials (via Service Accounts)
export MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id"
export MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret"

# Set a custom MongoDB connection string
export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase"

export MDB_MCP_LOG_PATH="/path/to/logs"

MCP 구성 파일 예제

환경 변수가 있는 연결 문자열

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      }
    }
  }
}

환경 변수가 포함된 Atlas API 자격 증명

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id",
        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret"
      }
    }
  }
}

명령줄 인수

서버를 시작할 때 구성 옵션을 명령줄 인수로 전달합니다.

npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs

MCP 구성 파일 예제

명령줄 인수가 있는 연결 문자열

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      ]
    }
  }
}

명령줄 인수가 포함된 Atlas API 자격 증명

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--apiClientId",
        "your-atlas-service-accounts-client-id",
        "--apiClientSecret",
        "your-atlas-service-accounts-client-secret"
      ]
    }
  }
}

🤝 기여하기

기여하고 싶으신가요? 좋습니다! 코드 기여, 표준, 새 도구 추가 및 문제 해결 정보에 대한 지침은 기여 가이드를 참조하세요.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI 어시스턴트가 자연어를 통해 MongoDB Atlas 리소스와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 데이터베이스 작업과 Atlas 관리 기능을 지원합니다.

Related MCP Servers

MongoDB MCP Server
jonfreeland
A
security
A
license
A
quality
A Model Context Protocol server that provides read-only access to MongoDB databases, enabling AI assistants to directly query and analyze MongoDB data while maintaining data safety.
Last updated -
14
9
2
JavaScript
MIT License
MCP-MongoDB-MySQL-Server
yaoxiaolinglong
A
security
A
license
A
quality
A Model Context Protocol server that enables AI models to interact with both MySQL and MongoDB databases through a standardized interface, supporting comprehensive database operations including queries, schema management, and CRUD operations.
Last updated -
14
6
JavaScript
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
TypeScript
Apollo.io MCP Server
lkm1developer
A
security
A
license
A
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Apollo.io data, performing operations like people/organization enrichment, searching, and retrieving job postings through natural language commands.
Last updated -
7
3
TypeScript
MIT License

View all related MCP servers

MongoDB MCP Server