motherduckdb/mcp-server-motherduck

해결하는 문제

이 프로젝트는 AI 어시스턴트와 IDE가 DuckDB 및 MotherDuck에 직접 연결할 수 있도록 해주는 Model Context Protocol (MCP) 서버를 제공합니다. LLM과 분석용 SQL 데이터베이스 사이의 격차를 메우며, AI 에이전트가 로컬 파일, 메모리 내 데이터베이스, S3 호스팅 데이터베이스 또는 클라우드 기반 MotherDuck 인스턴스에서 데이터 엔지니어링 및 SQL 분석을 수행할 수 있도록 합니다.

작동 방식

서버는 MCP 호환 클라이언트(예: Claude Desktop, Cursor, VS Code)를 위한 DuckDB의 SQL 엔진을 도구 세트로 노출하는 미들웨어 역할을 합니다. 읽기 전용 및 읽기/쓰기 모드를 포함한 여러 연결 모드를 지원하며, 실시간으로 다른 데이터베이스 연결로 전환할 수 있습니다. uvx를 통해 로컬에 배포하거나, stdio 또는 http 전송 방식을 사용한 Docker 컨테이너로 배포할 수 있습니다.

대상 사용자

• 데이터 엔지니어 및 분석가: AI 어시스턴트를 사용해 분석 데이터를 질의하고 관리하고 싶은 사용자
• AI 에이전트 개발자: SQL을 실행하고 데이터베이스 카탈로그를 탐색할 수 있는 능력이 필요한 에이전트를 개발하는 개발자
• IDE 사용자: AI 기반 IDE(Cursor 또는 VS Code 등)를 사용하며, 데이터 소스를 직접 코딩 워크플로우에 통합하고 싶은 사용자

주요 특징

• 다양한 연결성: 로컬 DuckDB 파일, 메모리 내 데이터베이스, S3 호스팅 데이터베이스, MotherDuck를 지원
• 유연한 접근 제어: 기본적으로 읽기 전용 모드, 생산 환경용 특정 보안 설정을 제공하는 읽기/쓰기 모드
• 포괄적인 도구 세트: 쿼리 실행, 데이터베이스, 테이블, 컬럼 목록 조회, 데이터베이스 연결 전환 도구 포함
• 광범위한 클라이언트 호환성: Claude Desktop, Claude Code, Gemini CLI, Cursor 등 다양한 MCP 클라이언트와 호환