mongodb-js/mongodb-mcp-server

A Model Context Protocol server to connect to MongoDB databases and MongoDB Atlas Clusters.

MongoDB MCP Server – 빠른 개요

정의 – AI 에이전트가 MongoDB 데이터베이스(자체 호스팅 및 MongoDB Atlas 모두)와 통신할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. Claude, Cursor, GitHub Copilot, Grok 등의 도구가 에이전트가 원시 연결 로직을 포함하지 않고도 데이터베이스 명령(find, aggregate, create-index 등)을 실행할 수 있도록 표준 프로토콜을 구현합니다.

중요성 – "데이터 인식" LLM 에이전트를 가능하게 합니다. 모델은 서버에 데이터를 요청하고, 쿼리를 실행하거나, Atlas에서 리소스를 생성할 수 있습니다. 모두 안전하고 기본적으로 읽기 전용인 인터페이스를 통해 수행됩니다.

주요 기능(README에 설명된 대로)

기능 세부 사항
지원되는 AI 클라이언트 통합 Cursor, VS Code, Claude, Codex, GitHub Copilot CLI, Grok, Gemini용 공식 플러그인. mongodb-atlas(OAuth를 통한 원격 Atlas MCP) 및 mongodb(모든 MongoDB 배포판용 로컬 서버) 두 개의 플러그인이 포함됩니다.
명령줄/Docker 배포 npx -y mongodb-mcp-server@latest --readOnly 또는 Docker(mongodb/mongodb-mcp-server:latest)로 로컬에서 실행합니다. 환경 변수는 MongoDB 연결 문자열 또는 Atlas 서비스 계정 자격 증명을 제공합니다.
기본 읽기 전용 서버는 데이터를 보호하기 위해 --readOnly로 시작합니다. 쓰기를 활성화하려면 플래그를 제거하세요.
풍부한 도구 세트 많은 MongoDB 작업을 MCP 도구로 노출합니다(예: find, aggregate, create-index, atlas-create-cluster, atlas-get-performance-advisor 등).
보안 권장 사항 비밀에는 환경 변수를 선호하고, 최소 Atlas API 권한을 부여하며, 명시적으로 쓰기가 필요하지 않는 한 서버를 읽기 전용 모드로 유지하세요.
구성 유연성 JSON 스타일 MCP 구성 파일, 명령줄 인수, 환경 변수 및 Docker 기반 시작을 지원합니다.
HTTP 호환성 사용자 지정 HTTP 클라이언트가 서버와 통신하는 방법(헤더, 리디렉션, 페이로드 제한)을 설명하는 별도의 라이브러리 가이드가 있습니다.
클라우드 배포 Azure 배포에 대한 언급(자세한 내용은 문서 참조).

일반적인 워크플로우

  1. AI 어시스턴트에 적절한 플러그인을 설치합니다(예: Claude Marketplace의 mongodb-atlas).
  2. 자격 증명을 제공합니다 – MongoDB URI(MDB_MCP_CONNECTION_STRING) 또는 Atlas 서비스 계정 클라이언트 ID/시크릿(MDB_MCP_API_CLIENT_ID / MDB_MCP_API_CLIENT_SECRET).
  3. 서버를 시작합니다 – npx 또는 Docker를 사용합니다. 서버는 AI 클라이언트가 MCP 프로토콜을 사용하여 통신하는 하위 프로세스로 실행됩니다.
  4. 명령을 실행합니다 – 에이전트는 find, aggregate-db, atlas-create-cluster 등의 도구를 호출하고 구조화된 JSON 결과를 받을 수 있습니다.
  5. 선택적 쓰기 액세스 – 보안 정책을 확인한 후 에이전트가 데이터를 수정해야 하는 경우 --readOnly를 제거하세요.

사용 대상

  • AI 증강 애플리케이션을 구축하는 개발자 – MongoDB에 저장된 데이터를 가져오거나 조작해야 하는 경우.
  • 데이터 과학 팀 – LLM이 MongoDB 데이터 세트를 안전하게 탐색하도록 하려는 경우.
  • 운영 팀 – AI 에이전트가 atlas-* 도구를 통해 Atlas 클러스터를 프로비저닝하거나 검사하도록 하려는 경우.

시작하기(빠른 명령)

# 빠른 로컬 시작(읽기 전용)
npx -y mongodb-mcp-server@latest setup   # 대화형 마법사
# 또는 직접 실행
npx -y mongodb-mcp-server@latest --readOnly

# Docker 대안
docker run --rm -i -e MDB_MCP_CONNECTION_STRING='mongodb://localhost:27017/myDb' \
    -e MDB_MCP_READ_ONLY='true' mongodb/mongodb-mcp-server:latest

자세히 알아보기

  • 전체 문서: https://www.mongodb.com/docs/mcp-server/
  • 플러그인 마켓플레이스: Cursor, Claude, GitHub Copilot, Grok, Gemini.
  • 사용자 지정 HTTP 클라이언트용 라이브러리 가이드: MCP_SERVER_LIBRARY.md.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.

관련

  • 프로젝트
    motherduckdb/mcp-server-motherduck

    DuckDB(로컬, S3 또는 MotherDuck)를 래핑하는 자체 호스팅형 MCP 서버로, AI 어시스턴트가 Model-Chat-Protocol을 통해 SQL 쿼리를 실행할 수 있습니다. stdio 또는 HTTP, 읽기/쓰기 제어, Docker 배포, Claude, Gemini, Cursor 등과의 통합을 지원합니다.

  • 프로젝트
    SonarSource/sonarqube-mcp-server

    SonarQube MCP Server는 Docker 기반 브리지로, AI 코딩 어시스턴트(Claude, Gemini, Copilot, Cursor, VS Code 등)가 SonarQube 인스턴스에 코드 품질 및 보안 결과를 쿼리할 수 있게 합니다. 온라인 구성 생성기 또는 `sonarsource/sonarqube-mcp` 이미지 실행을 통해 설정하고, SonarQube 토큰(및 선택적 org 또는 서버 URL)을 환경 변수로 제공하고, 생성된 JSON 스니펫을 에이전트의 MCP 구성에 추가합니다. 그런 다음 서버는 프로젝트 전체 또는 스니펫 수준 분석에 대한 에이전트의 요청에 응답하여 AI 증강 개발 워크플로우 내에서 신뢰할 수 있고 최신의 정적 분석 데이터를 제공합니다.

  • 프로젝트
    googleapis/mcp-toolbox

    MCP Toolbox는 AI 에이전트와 IDE가 Model Context Protocol을 통해 엔터프라이즈 데이터베이스와 통신할 수 있게 해주는 오픈소스 서버입니다. 즉시 사용 가능한 데이터베이스 도구와 안전한 SQL/시맨틱 검색 도구를 정의하기 위한 프레임워크를 제공하며, Python, JS/TS, Go, Java용 SDK를 지원합니다.

  • 프로젝트
    designcomputer/mysql_mcp_server

    AI 애플리케이션이 구조화된 인터페이스를 통해 MySQL 데이터베이스를 안전하게 탐색하고 질의할 수 있도록 해주는 Model Context Protocol (MCP) 서버입니다.

  • 프로젝트
    a-bonus/google-docs-mcp

    Node.js MCP 서버로, AI 에이전트(Claude Desktop, Cursor 등)가 자연어 스타일의 도구 호출을 통해 Google Docs, Sheets, Drive 파일, Gmail 메시지, 캘린더 이벤트 및 Apps Script 프로젝트를 읽고, 편집하고, 관리할 수 있게 합니다. OAuth 설정 후 `npx`를 통해 로컬에서 작동하거나 팀 전체 사용을 위해 Cloud Run에 배포할 수 있습니다.