자료실
데이터베이스MCP 서버official

DuckDB (MotherDuck)

로컬 DuckDB 파일과 MotherDuck 클라우드를 함께 다루는 공식 서버

자료 등록 2026년 4월 16일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
MCP · 로컬 stdio
인증
API 키·토큰 또는 서비스 자격증명
비용
서버는 무료 공개, 연결 서비스 비용은 별도 확인
제공 상태
공개 제공
공식 빠른 시작GitHub · https://github.com/motherduckdb/mcp-server-motherduck

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

여러 파일을 스프레드시트로 합치다 형식과 행 수가 달라 반복 분석이 깨지는 업무

어떤 어려움인가
CSV와 Parquet를 빠르게 분석하는 실무팀이 자주 마주치는 문제입니다. 구체적으로는 '여러 파일을 스프레드시트로 합치다 형식과 행 수가 달라 반복 분석이 깨지는 업무' 상황입니다.
이렇게 해결합니다
DuckDB (MotherDuck) 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '로컬 파일 경로, 컬럼 규칙, 필터와 집계 기준'입니다. 필요한 필드만 골라 '정제 행 수와 집계 결과·제외 사유가 있는 분석표' 형태로 정리합니다.
왜 연결하는가
처음에는 DuckDB (MotherDuck) 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '정제 행 수와 집계 결과·제외 사유가 있는 분석표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위로컬 파일 경로, 컬럼 규칙, 필터와 집계 기준
    업무 조건
  2. 02 · 현재 자료DuckDB (MotherDuck)MCP 도구 호출: 입력 범위는 '로컬 파일 경로, 컬럼 규칙, 필터와 집계 기준'입니다. 필요한 필드만 골라 '정제 행 수와 집계 결과·제외 사유가 있는 분석표' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '정제 행 수와 집계 결과·제외 사유가 있는 분석표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과정제 행 수와 집계 결과·제외 사유가 있는 분석표

Result

이 흐름으로 남는 값

연결

연결

uvx mcp-server-motherduck --db-path :memory: --read-write

무엇이고 왜 필요한가

DuckDB·MotherDuck MCP는 로컬 파일 분석용 DuckDB와 클라우드 MotherDuck을 같은 SQL 흐름으로 다루는 공식 서버입니다. 별도 데이터베이스를 구축하기 전에 CSV·Parquet 파일을 즉석에서 구조적으로 확인할 때 유용합니다.

할 수 있는 일

  • 로컬 DuckDB 파일과 메모리 데이터베이스에 SQL을 실행합니다.
  • MotherDuck 토큰을 연결하면 클라우드 데이터베이스도 같은 방식으로 조회합니다.

시작 전 확인

  • 인증·비용 조건은 API 키·토큰 또는 서비스 자격증명, 서버는 무료 공개, 연결 서비스 비용은 별도 확인이며 제공 상태는 공개 제공입니다.
  • 첫 연결은 테스트 공간에서 조회 도구 하나만 실행해 실제로 노출되는 데이터와 권한 범위를 확인합니다.

잘 맞는 경우

  • CSV·Parquet 검수, 일회성 데이터 탐색, 분석 파이프라인 전 단계의 빠른 실증.

주의점

  • 로컬 파일 경로와 클라우드 토큰을 분리하고, 읽기 전용 기본값과 메모리·파일 크기 제한을 유지합니다.
  • 운영 연결 전에는 노출되는 도구와 읽기·쓰기 권한을 목록으로 남기고, 변경 작업은 대상과 내용을 확인한 뒤 실행합니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기