AI 칼럼

데이터@donghyeok99운영진

DBX: 100개가 넘는 DB를 에이전트에게 여는 25MB 클라이언트

Claude Code에게 「지난 7일 주문 수 세 줘」라고 하면, DBX에 저장해 둔 연결로 바로 쿼리를 돌리는 25MB DB 클라이언트

에이전트의 조회 요청은 읽기 전용 자물쇠를 지나 DBX의 orders 표에 줄줄이 채워지고, DELETE는 같은 자물쇠에서 막혀요.
에이전트의 조회 요청은 읽기 전용 자물쇠를 지나 DBX의 orders 표에 줄줄이 채워지고, DELETE는 같은 자물쇠에서 막혀요.
누가
GitHub의 t8y2와 기여자들이 만들어요. 여러 종류의 DB를 한 앱에서 다루고, 그 연결을 AI 에이전트에게도 쓰게 하려는 사람을 위한 도구예요.
언제
저장소는 2026년 4월 29일에 열렸어요. MCP 서버 패키지 0.4.142가 2026년 11월 11일에 나왔어요.
어디서
macOS, Windows, Linux 데스크톱 앱과 Docker 웹판이 있어요. MCP 서버는 따로 설치하고 Claude Code, Cursor, Windsurf에 붙어요.

이게 불편했어요

에이전트에게 「이번 주 주문 몇 건이야」를 물으려면 DB 주소와 비밀번호를 또 건네야 했어요. 넘기고 나면 에이전트가 조회만 할지, 실수로 지우거나 테이블을 바꿀지 막을 곳도 마땅치 않았어요.

그래서 이렇게 풀어요

DBX는 원래 MySQL부터 Redis, MongoDB, ClickHouse까지 한 앱에서 여는 가벼운 DB 클라이언트예요. 여기에 따로 설치하는 MCP 서버가 붙어서, 에이전트는 DBX에 이미 저장한 연결을 그대로 써요. 어떤 연결을 보여 줄지와 읽기 전용, 데이터 읽기/쓰기, 전체 권한 중 무엇을 허락할지는 DBX 설정 한 곳에서 정하고, 서버가 요청마다 그 설정을 다시 확인해요.

DBX 메인 화면
DBX 메인 화면
테이블 관계를 그려 주는 ER 다이어그램
테이블 관계를 그려 주는 ER 다이어그램
큰 결과도 스크롤로 넘기는 데이터 그리드
큰 결과도 스크롤로 넘기는 데이터 그리드

이걸로 만든 사람들

GitHub@tw20662026-11-11

프로젝트 CLAUDE.md에 「DB 작업은 dbx MCP를 먼저 쓴다」는 규칙을 두고 Claude Code로 MySQL을 조사하는 사람이에요. 계획 모드에서 읽기 쿼리마다 확인 창이 떠 열 번 넘게 눌러야 했다며, 조회와 쓰기 도구를 나눠 달라고 재현 단계와 함께 올렸어요.

一次计划阶段的数据探查往往要连续查询十几次(看表结构 → 看数据分布 → 抽样验证),用户被迫点十几次确认;
댓글 1 (2026-11-11 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    Claude Code · Cursor → dbx-mcp (Rust)

    npx -y @dbx-app/mcp-server작은 Node 런처가 운영체제와 CPU에 맞는 Rust 바이너리 dbx-mcp를 찾아 띄워요.packages/mcp-server/bin/dbx-mcp-server.js
  2. 2

    dbx-mcp (Rust) → 설정 → MCP 정책

    허용 연결과 권한 모드 다시 읽기읽기 전용, 데이터 읽기/쓰기, 전체 권한 중 무엇인지 요청마다 다시 읽고, 허용 목록 밖 연결은 보이지 않아요.crates/dbx-core/src/ai/mcp_policy.rs
  3. 3

    dbx-mcp (Rust) → DBX에 저장한 연결

    dbx_execute_query (기본 100행)저장된 연결로 SQL이나 MongoDB 명령을 실행하고, max_rows를 주면 1000행까지 돌려줘요.crates/dbx-mcp/src/server.rs
  4. 4

    dbx-mcp (Rust) → 나

    위험한 SQL은 확인 창전체 권한에서 넓은 삭제나 DDL 같은 고위험 SQL은 데스크톱에 띄워 사람이 정하게 해요.apps/desktop/src/components/mcp/McpSqlApprovalDialog.vue
  5. 5

    dbx-mcp (Rust) → 답과 DBX 결과 표

    dbx_execute_and_show결과를 에이전트에게 돌려주고, 켜져 있는 DBX 데스크톱에도 같은 결과를 표로 띄워요.crates/dbx-mcp/src/server.rs

넣으면 이렇게 나와요

List my DBX connectionsMCP에 허용한 연결 목록이 저장해 둔 메모와 함께 와요.
Count orders created in the last seven daysdbx_execute_query로 SQL을 실행하고 결과를 돌려줘요. 기본 100행이에요.
Open the orders table in DBX켜져 있는 DBX 데스크톱에 orders 테이블이 열려요.
Run INFO memory on the Redis connectionRedis 연결에 명령을 보내고 결과를 받아요.

나한테 맞을까요

이럴 때 좋아요

  • MySQL, PostgreSQL, Redis, MongoDB를 한 앱에서 오가는 개발자
  • Claude Code나 Cursor에게 DB 조회를 맡기되 쓰기는 막아 두고 싶을 때
  • 팀이 Docker로 띄운 웹판 DBX를 에이전트와 같이 쓰고 싶을 때
  • DBeaver나 Navicat 연결 설정을 옮겨 와서 가볍게 쓰고 싶을 때

이건 안 돼요

  • MCP 서버는 데스크톱 앱과 따로 설치해야 해요. dbx_open_table과 dbx_execute_and_show는 DBX 데스크톱이 켜져 있어야 해요.
  • Agent/JDBC 방식 DB는 맞는 에이전트, JDBC 드라이버, JRE가 있어야 해요.
  • Linux용 네이티브 바이너리는 glibc만 되고, Alpine/musl은 아직 안 돼요.
  • Claude Code 계획 모드에서는 읽기 쿼리마다 확인 창이 뜬다는 요청이 이슈 #14727로 올라와 있어요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기