본문으로 건너뛰기

macOS 앱v0.1.1

MongoDB Grep

Mac에서 MongoDB를 조회해 결과를 암호화한 Excel로 내보냅니다.

MongoDB Grep은 Apple silicon Mac용 네이티브 MongoDB 클라이언트입니다. 단일 쿼리부터 여러 컬렉션을 이어 조회하는 파이프라인까지 실행하고 결과를 암호가 걸린 Excel 파일로 저장합니다.

실행한 쿼리는 쿼리 로그에, Excel 반출 내역은 감사 이력에 남으며 두 기록 모두 이 Mac의 로컬 파일로 저장됩니다. 앱에 내장된 mongosh로 MongoDB와 통신하므로 별도로 mongosh를 설치하지 않아도 바로 쓸 수 있습니다.

  • Apple silicon
  • macOS 26 이상
  • 출시
쿼리를 실행한 뒤 결과를 표, 트리, JSON 보기로 전환해 살펴보는 모습입니다. 데모용 로컬 MongoDB와 가상 데이터로 촬영했습니다.

Mac에서 MongoDB 데이터를 직접 조회하고 결과를 다른 사람에게 파일로 전달해야 할 때 잘 맞습니다.

주요 기능

쿼리 실행과 결과 보기 전환

연결은 동시에 4개까지, 탭은 연결마다 16개까지 열어 두고 ⌘↩로 쿼리를 실행합니다. 실행 결과는 ⌘1부터 ⌘3 단축키로 표, 트리, JSON 보기를 오가며 살피고 explain 결과가 있으면 ⌘4로 실행 계획까지 바로 확인합니다.

shop.orders 컬렉션의 find 결과를 트리 보기로 펼친 MongoDB Grep 탐색 화면

여러 단계를 잇는 파이프라인

직접 입력하거나 CSV에서 불러온 값 목록으로 시작해 여러 쿼리 단계를 차례대로 실행합니다. 단계 사이를 left나 inner로 조인하거나 replace로 앞 단계 결과를 바꿀 수 있습니다. 본 실행 전에 시험 실행을 돌리면 단계마다 100행만 먼저 읽어 결과 형태를 빠르게 점검합니다.

고객 12명의 ID 목록으로 customers와 orders를 조인해 65행을 얻은 파이프라인 시험 실행 결과

사유를 남기는 암호화 Excel 반출

쿼리나 파이프라인 결과를 앱이 자동 생성한 암호로 잠근 Excel 파일(OOXML Agile Encryption, AES-256)로 저장합니다. 반출 사유를 입력해야 작업을 시작할 수 있으며 워크북을 메모리에서 바로 암호화해 디스크에 쓰기 때문에 평문 Excel 파일이 남지 않습니다.

반출 대상 건수, 가려진 표본, 반출 쿼리, 자동 생성 암호가 보이는 안전 반출 시트

로컬에 남는 감사 이력

Excel을 반출하면 OS 계정, 반출 사유, 건수, 파일 SHA-256 해시가 감사 이력에 남고 쿼리는 실행 직전에 쿼리 로그에 먼저 기록됩니다. 로그 기록에 실패하면 쿼리 자체가 실행되지 않으며 두 기록 모두 SQLite 트리거로 막아 두어 수정이나 삭제, 교체를 할 수 없습니다.

사용자, 시각, 대상, 사유, 건수, 해시가 기록된 감사 이력 창

그 밖의 기능

  • 연결 관리연결마다 이름과 설명, 구분 색상을 지정하고 실수를 막고 싶은 대상은 보호된 연결로 표시해 둘 수 있습니다.
  • 보호된 연결보호된 연결의 탐색 화면에서는 쿼리가 읽기 전용인지 확인되지 않으면 실행 전에 확인 창을 한 번 더 띄웁니다.
  • 저장 전 변경 검토결과 화면에서 값을 고치면 바로 반영하지 않고 변경분을 모아 둡니다. 실제로 실행될 스크립트를 눈으로 확인한 뒤 한꺼번에 저장하거나 되돌릴 수 있습니다.
  • 필드와 값 자동완성현재 컬렉션의 문서 100건을 표본으로 읽어 필드 경로와 값을 추천하며 인덱스가 걸린 필드를 목록 위쪽에 먼저 보여 줍니다.
  • 컬렉션 복사와 이름 확인 삭제컬렉션을 다른 데이터베이스나 연결로 복사할 수 있습니다. 컬렉션이나 데이터베이스는 대상 이름을 직접 입력해야 삭제됩니다.
  • 슬로우 쿼리 창탐색 화면에서 실행에 100ms 이상 걸린 쿼리만 최신순으로 따로 모아 보여 줍니다.
  • AI 쿼리 초안찾고 싶은 데이터를 문장으로 적으면 로컬에 설치된 claude CLI가 mongosh 쿼리 초안을 작성해 편집기에 채워 줍니다. 초안을 자동으로 실행하지는 않습니다.
  • 테마와 언어8가지 색상 테마를 고를 수 있으며 화면 언어는 한국어와 영어를 지원합니다.

내려받기와 설치

Homebrew로 설치

brew install --cask ClaudeSeo/tap/mongodb-grep

직접 설치

  1. .dmg 파일을 내려받아 엽니다.
  2. MongoDB Grep.app을 응용 프로그램 폴더로 끌어다 놓습니다.
  3. 앱을 실행한 뒤 연결 추가에서 이름과 연결 문자열을 입력해 접속합니다.

앱 자체의 자동 업데이트 기능은 없습니다. brew upgrade --cask mongodb-grep 명령을 실행하거나 새 버전의 .dmg 파일로 바꿔 설치합니다.

다른 앱