MongoDB MCP Server

Name: MongoDB MCP Server MCP Server
Author: kiliczsh

왜 쓰나요

핵심 기능

CLI 인수로 connection string 전달 — 환경 파일 불필요
읽기 전용 모드로 모든 변경 작업 비활성화
샘플 문서에서 스키마 추론
집계 파이프라인 지원
쿼리 튜닝 대화를 위한 인덱스 검사

라이브 데모

실제 사용 모습

mongo-mcp-kiliczsh.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mongo-mcp-kiliczsh",
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "mongo-mcp-kiliczsh": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-mongo-server",
          "mongodb://localhost:27017/mydb"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mongo-mcp-kiliczsh -- npx -y mcp-mongo-server mongodb://localhost:27017/mydb

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: MongoDB MCP Server

낯선 MongoDB 데이터베이스를 아무것도 쓰지 않고 탐색

👤 새 서비스에 온보딩 중인 개발자 ⏱ ~15 min beginner

언제 쓸까: Mongo 인스턴스를 인수받았는데 스키마가 문서화되지 않았을 때.

사전 조건

읽기 전용 Mongo 사용자 — db.createUser({user:'reader', roles:[{role:'read', db:'mydb'}]})

흐름

읽기 전용 연결

Use the mongo MCP. List all collections and infer the schema for the top 3 by size.✓ 복사됨

→ 컬렉션 목록 + 컬렉션별 JSON 스키마
샘플 확인

Show me 5 sample documents from orders — anonymize emails.✓ 복사됨

→ PII가 제거된 5개 문서
관계 매핑

Which collections reference each other by ObjectId? Draw a quick text diagram.✓ 복사됨

→ 텍스트 형식 ER 다이어그램

결과: 10분 안에 DBA 없이 데이터베이스의 실용적인 멘탈 모델 구축.

함정

샘플링이 고 카디널리티 필드를 놓침 — 추론 호출의 샘플 크기 증가; 시간 편향 데이터는 날짜 범위로 샘플링

함께 쓰기: filesystem

Claude의 인덱스 조언으로 느린 집계 쿼리 튜닝

👤 백엔드 개발자 ⏱ ~25 min intermediate

언제 쓸까: 집계 파이프라인이 30초 걸리는데 어느 단계가 원인인지 모를 때.

흐름

프로파일링

Run this aggregation with explain=true. Show the winning plan.✓ 복사됨

→ 단계별 스캔 문서 수가 포함된 실행 계획
진단

Which stage is the bottleneck? What index would help?✓ 복사됨

→ 근거가 포함된 구체적인 인덱스 제안
검증

Re-explain after I add the index. Did totalDocsExamined drop?✓ 복사됨

→ 수치가 포함된 예/아니오 답변

결과: 인덱스 하나로 10배 빨라진 집계 쿼리.

함정

Claude가 쓰기를 느리게 만드는 인덱스를 제안할 수 있음 — 적용 전 '이 인덱스의 쓰기 페널티는?'을 먼저 물어볼 것

암묵적 스키마를 위반하는 문서 찾기

👤 데이터 엔지니어 ⏱ ~20 min intermediate

언제 쓸까: 스키마리스 DB에 드리프트가 쌓였을 때; 위반 문서를 찾아야 할 때.

흐름

샘플링

Sample 1000 documents from users. What fields are missing or have unexpected types?✓ 복사됨

→ 필드별 null 비율 / 타입 빈도 테이블
검색

Find all users where email is null or not a string.✓ 복사됨

→ 카운트 + 샘플 _id

결과: 마이그레이션 스크립트에 전달할 수 있는 구체적인 더러운 데이터 보고서.

함정

대용량 컬렉션에서 타임아웃 발생 — $sample 사용 후 범위로 후속 조회 범위 제한

조합

다른 MCP와 조합해 10배 효율

mongo-mcp-kiliczsh + filesystem

집계 결과를 하위 도구용 JSON으로 내보내기

mongo-mcp-kiliczsh + github

드리프트 발견 후 마이그레이션 스크립트로 PR 열기

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
find	collection, filter, projection?, limit?	특정 문서 조회	쿼리 1회
aggregate	collection, pipeline[], explain?	데이터 그룹화/변환	쿼리 1회
list_collections	(없음)	DB 내용 탐색	무료
schema	collection, sample_size?	샘플 문서에서 구조 추론	샘플 읽기 1회
list_indexes	collection	튜닝 대화	무료
insert_one	collection, document	--read-only 모드가 아닐 때만 사용	쓰기 1회

비용 및 제한

운영 비용

API 쿼터: Mongo 클러스터의 RU/IOPS 제한에 따름
호출당 토큰: 결과 크기에 따라 200–5000
금액: 무료 (오픈 소스)
팁: 필요한 필드만 projection; 초반에 limit 제한

보안

권한, 시크릿, 파급범위

최소 스코프: 대상 DB에 대한 read 권한

자격 증명 저장: URI를 CLI 인수로 전달 — 셸 히스토리에서 제외

데이터 외부 송신: Mongo 호스트에만 전송

절대 부여 금지: dbAdmin root

비밀번호가 포함된 URI는 프로세스 인수에 표시됨; 일부 시스템에서 로깅될 수 있음

문제 해결

자주 발생하는 오류와 해결

MongoServerSelectionError

연결, IP 허용 목록, TLS 설정 확인

확인: 동일 URI로 mongosh 실행

인증 실패

URI의 authSource 확인 (보통 admin); 해당 DB에 사용자 존재 확인

읽기 전용 모드에서 도구를 찾을 수 없음

쓰기가 필요하면 --read-only 제거; 아니면 쓰기용 다른 MCP 사용

대안