DBX: 100개가 넘는 DB를 에이전트에게 여는 25MB 클라이언트
Claude Code에게 「지난 7일 주문 수 세 줘」라고 하면, DBX에 저장해 둔 연결로 바로 쿼리를 돌리는 25MB DB 클라이언트
- 누가
- 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 설정 한 곳에서 정하고, 서버가 요청마다 그 설정을 다시 확인해요.



이걸로 만든 사람들
프로젝트 CLAUDE.md에 「DB 작업은 dbx MCP를 먼저 쓴다」는 규칙을 두고 Claude Code로 MySQL을 조사하는 사람이에요. 계획 모드에서 읽기 쿼리마다 확인 창이 떠 열 번 넘게 눌러야 했다며, 조회와 쓰기 도구를 나눠 달라고 재현 단계와 함께 올렸어요.
一次计划阶段的数据探查往往要连续查询十几次(看表结构 → 看数据分布 → 抽样验证),用户被迫点十几次确认;
안에서는 이렇게 돌아가요
- 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
dbx-mcp (Rust) → 설정 → MCP 정책
허용 연결과 권한 모드 다시 읽기읽기 전용, 데이터 읽기/쓰기, 전체 권한 중 무엇인지 요청마다 다시 읽고, 허용 목록 밖 연결은 보이지 않아요.crates/dbx-core/src/ai/mcp_policy.rs - 3
dbx-mcp (Rust) → DBX에 저장한 연결
dbx_execute_query (기본 100행)저장된 연결로 SQL이나 MongoDB 명령을 실행하고, max_rows를 주면 1000행까지 돌려줘요.crates/dbx-mcp/src/server.rs - 4
dbx-mcp (Rust) → 나
위험한 SQL은 확인 창전체 권한에서 넓은 삭제나 DDL 같은 고위험 SQL은 데스크톱에 띄워 사람이 정하게 해요.apps/desktop/src/components/mcp/McpSqlApprovalDialog.vue - 5
dbx-mcp (Rust) → 답과 DBX 결과 표
dbx_execute_and_show결과를 에이전트에게 돌려주고, 켜져 있는 DBX 데스크톱에도 같은 결과를 표로 띄워요.crates/dbx-mcp/src/server.rs
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 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 편집자가 검토했어요. 칼럼은 어떻게 만드나요