MongoDB MCP Server — Claude Code MCP 서버

MongoDB 데이터베이스 및 Atlas 클러스터에 연결하는 공식(mongodb-js) MCP 서버. 컬렉션 탐색, 쿼리, read-only 모드를 지원한다.

MongoDB MCP Server는 MongoDB가 직접 관리하는 공식(mongodb-js) MCP(Model Context Protocol) 서버로, Claude Code 같은 AI 클라이언트를 MongoDB 데이터베이스 및 MongoDB Atlas 클러스터에 연결해 줍니다. 연결 문자열(MDB_MCP_CONNECTION_STRING)로 대상 인스턴스를 지정하면, AI가 데이터베이스·컬렉션 구조를 탐색하고 문서를 조회하거나 쿼리를 실행할 수 있어, 스키마를 일일이 사람이 설명하지 않아도 됩니다.

이 서버가 푸는 문제는 명확합니다. 그동안 AI에게 MongoDB 데이터를 보여주려면 사람이 직접 쿼리를 돌려 결과를 복사해 붙여넣거나, 별도 도구를 만들어야 했습니다. MCP 서버를 붙이면 AI가 자연어 요청을 받아 컬렉션 목록 확인, 인덱스·필드 구조 파악, 필터·집계 쿼리 실행 같은 작업을 직접 수행합니다. 덕분에 "이 컬렉션 스키마 분석해줘", "최근 가입 유저 통계 뽑아줘" 같은 요청을 코드 작성 단계 없이 처리할 수 있습니다.

핵심 기능으로는 컬렉션·데이터베이스 탐색, 문서 쿼리, 그리고 read-only(읽기 전용) 모드 지원이 있습니다. read-only 모드는 AI가 데이터를 변경하지 못하도록 묶어두는 안전장치로, 운영 DB를 조사·분석 용도로 연결할 때 특히 유용합니다. 자체 호스팅 MongoDB는 물론 클라우드인 Atlas 클러스터에도 연결됩니다.

이 서버는 MongoDB를 백엔드로 쓰는 개발자, 데이터 구조를 빠르게 파악하고 싶은 백엔드·풀스택 엔지니어, 운영 데이터를 안전하게(read-only) 살펴보며 디버깅하거나 리포트를 만들려는 팀에게 적합합니다. 구체적인 설치·인증·도구 목록과 최신 옵션은 버전에 따라 달라질 수 있으므로 공식 GitHub 저장소(mongodb-js/mongodb-mcp-server) 문서 확인을 권장합니다.

언제 쓰나

MongoDB나 Atlas를 백엔드로 쓰는 프로젝트에서 AI에게 DB 구조·데이터를 직접 보여주고 싶을 때 적합합니다. 컬렉션 스키마 파악, 쿼리·집계 결과 확인, 운영 데이터 디버깅, 데이터 기반 리포트 작성처럼 사람이 매번 쿼리를 돌려 붙여넣던 작업을 줄여줍니다. 특히 운영 DB는 read-only 모드로 연결해 조사·분석만 안전하게 수행할 때 효과적입니다.

설치

claude mcp add mongodb --env MDB_MCP_CONNECTION_STRING=$MDB_MCP_CONNECTION_STRING -- npx -y mongodb-mcp-server@latest

npx로 mongodb-mcp-server를 실행하므로 Node.js 환경이 필요합니다. 연결 대상은 환경변수 MDB_MCP_CONNECTION_STRING(MongoDB 연결 문자열)로 지정하며, 셸에 미리 export해 두거나 클라이언트 환경에 설정해야 합니다. Atlas 연결 시 IP 접근 목록·네트워크 허용, 자체 호스팅 시 인증·네트워크 도달성을 먼저 확인하세요. read-only 등 모드·옵션과 지원 도구는 버전에 따라 달라질 수 있으니 공식 저장소 문서 확인을 권장합니다.

필요 키(직접 발급, 플레이스홀더): MDB_MCP_CONNECTION_STRING

보안 주의

MDB_MCP_CONNECTION_STRING에는 DB 사용자·비밀번호가 포함되는 경우가 많으므로 비밀키로 취급해 코드·로그·커밋에 노출하지 마세요. 이 서버는 데이터베이스 전체 데이터에 접근할 수 있어, 권한이 넓은 계정을 연결하면 AI가 의도치 않게 민감 데이터를 읽거나(쓰기 허용 시) 변경·삭제할 수 있습니다. 운영 DB는 가급적 read-only 모드 + 최소권한 전용 계정으로 연결하고, 분석은 사본/스테이징에서 수행하길 권장합니다. 또한 DB에 저장된 외부 입력 문서가 프롬프트 인젝션 경로가 될 수 있으니, 조회 결과를 그대로 신뢰해 파괴적 작업을 자동 실행하지 마세요.

자주 묻는 질문

MongoDB Atlas 클러스터에도 연결되나요?

네. 자체 호스팅 MongoDB와 Atlas 클러스터 모두 연결을 지원합니다. Atlas는 연결 문자열과 함께 IP 접근 목록·네트워크 허용 설정이 맞아야 도달할 수 있으며, 구체적 설정은 공식 저장소 문서 확인을 권장합니다.

AI가 실수로 데이터를 변경하거나 지우지 않게 할 수 있나요?

read-only(읽기 전용) 모드를 지원하므로 조사·분석 용도로 연결할 때 이를 켜면 쓰기·삭제를 막을 수 있습니다. 더 안전하게는 읽기 전용 권한만 가진 전용 DB 계정을 만들어 연결 문자열에 사용하는 것을 권장합니다.

연결 문자열은 어떻게 전달하나요?

환경변수 MDB_MCP_CONNECTION_STRING으로 전달합니다. 자격증명이 포함되므로 비밀키로 취급해 커밋·로그에 노출하지 말고, 셸 export나 클라이언트 환경설정으로 안전하게 주입하세요.