tibero-mcp

Let AI agents read your Tibero schema. Nothing gets written unless you say so. AI 에이전트가 Tibero 스키마를 읽습니다. 허락하기 전에는 아무것도 쓰지 않습니다.

An MCP server for Claude Code, Codex and Cursor that finds tables by their Korean comments, explains keys and plans, and runs only the queries you would let a new colleague run. Claude Code, Codex, Cursor에서 쓰는 MCP 서버입니다. 한글 주석으로 테이블을 찾고, 키와 실행 계획을 설명하며, 새로 온 동료에게 허락할 만한 쿼리만 실행합니다.

claude mcp add -s user tibero -- uv --directory ./tibero-mcp run tibero-mcp
Claude Code · tibero
  1. Where do we keep order dates for sales? 판매 쪽 주문일은 어디에 저장돼?
  2. search_columns(keyword="주문", table_search="판매")
  3. TABLECOLUMNTYPECOMMENT
    SALES_ORDERORDER_DATETIMESTAMP(6)주문 일자
    SALES_ORDERORDER_USERVARCHAR(20)주문 담당자
    ORDER_LINEDELIVERY_DATETIMESTAMP(6)납기 일자
  4. Mark every order as shipped. 전부 출고 완료로 바꿔 줘.
  5. query("UPDATE SALES_ORDER SET STATUS = 'SHIPPED'")
  6. Refused.거부됨. UPDATE is not a query, and this server is read-only. Nothing reached the database. UPDATE는 조회가 아니고, 이 서버는 조회 전용입니다. 데이터베이스에는 아무것도 전달되지 않았습니다.

Built for how agents work on real Tibero schemas실제 Tibero 스키마를 다루는 에이전트에 맞췄습니다

Earlier Tibero MCP servers handed the model a raw SQL pipe with commits on and left you to find a JDBC jar. This one starts from safety and works up. 기존 Tibero MCP 서버는 커밋까지 되는 SQL 통로를 모델에 그대로 열어 주고, JDBC jar는 사용자가 알아서 구해야 했습니다. 이 서버는 안전에서 출발합니다.

Safe by default기본값이 안전합니다

Tibero ignores the JDBC read-only flag and has no SET TRANSACTION READ ONLY, so the server enforces read-only itself, in layers: Tibero는 JDBC 읽기 전용 플래그를 무시하고 SET TRANSACTION READ ONLY도 없습니다. 그래서 서버가 여러 겹으로 직접 막습니다.

Tool surface도구 구성No execute tool unless you turn writes on쓰기를 켜기 전에는 execute 도구가 없음
Statement check문장 검사Only SELECT/WITH, one statement, no FOR UPDATESELECT·WITH만, 한 문장만, FOR UPDATE 금지
Transaction트랜잭션Every read ends in a rollback모든 조회는 롤백으로 끝남
Your account접속 계정Grant SELECT only, and nothing else can slip throughSELECT 권한만 주면 그 밖의 경로도 닫힘

Schema discovery that reads comments주석을 읽는 스키마 탐색

Search tables and columns by their comments, then get columns, keys, foreign keys and indexes in one call. 주석으로 테이블과 컬럼을 검색하고, 컬럼·키·외래키·인덱스를 한 번의 호출로 확인합니다.

Results an agent can use에이전트가 바로 쓰는 결과

Typed JSON, paged results with a next_offset, timeouts, plans as a tree, and errors that say what to try next. 타입이 살아 있는 JSON, next_offset으로 이어 받는 페이지 단위 결과, 타임아웃, 트리 형태의 실행 계획, 다음 행동을 알려 주는 오류 메시지.

No driver hunting드라이버를 찾아다닐 필요 없음

The official JDBC driver comes from Maven Central on first run, checked against a pinned SHA-1. 공식 JDBC 드라이버를 첫 실행 때 Maven Central에서 받아 고정된 SHA-1로 검증합니다.

Runs alongside other agents다른 에이전트와 함께 운영

stdio or Streamable HTTP, automatic reconnect, and a clean exit when the client leaves. stdio와 Streamable HTTP, 자동 재연결, 클라이언트가 떠나면 깔끔한 종료.

Quick start빠른 시작

Python 3.12+, uv and Java 8+. The driver downloads itself the first time the server connects. Python 3.12 이상, uv, Java 8 이상이 필요합니다. 드라이버는 서버가 처음 접속할 때 알아서 내려받습니다.

  1. Clone내려받기

    Get the source and install dependencies.소스를 받고 의존성을 설치합니다.

    git clone https://github.com/jdk1021/tibero-mcp.git
    cd tibero-mcp
    uv sync
  2. Configure접속 정보 입력

    Copy the template and fill in host, database name, user and password.템플릿을 복사하고 호스트, DB 이름, 계정, 비밀번호를 입력합니다.

    cp env.example .env
    $EDITOR .env
  3. Register클라이언트에 등록

    Add it to Claude Code, or any MCP client, and start asking.Claude Code나 다른 MCP 클라이언트에 추가하고 바로 질문하면 됩니다.

    claude mcp add -s user tibero -- \
      uv --directory $PWD run tibero-mcp

Tools도구

Six read tools are always available. The seventh exists only when you ask for it. 조회 도구 여섯 개는 항상 제공되고, 일곱 번째는 직접 켤 때만 생깁니다.

Tool도구What it does기능
list_schemasSchemas with table and view counts스키마별 테이블·뷰 수
list_tablesTables and views with comments and row estimates, filtered by name or comment테이블·뷰와 주석, 추정 행 수. 이름이나 주석으로 필터
describe_tableColumns, primary, unique and foreign keys, indexes컬럼, 기본키·유니크키·외래키, 인덱스
search_columnsColumns across a schema matched by name or comment스키마 전체에서 이름이나 주석으로 컬럼 검색
queryOne SELECT/WITH with bind parameters and a row capSELECT·WITH 한 문장, 바인드 변수와 행 수 상한
explainExecution plan as a tree with cost, cardinality and predicates비용·카디널리티·조건이 붙은 트리 형태의 실행 계획
executeDML, DDL or PL/SQL, committed on successDML·DDL·PL/SQL 실행 후 커밋only with TIBERO_READ_ONLY=falseTIBERO_READ_ONLY=false일 때만

The driver, without the scavenger hunt드라이버는 알아서 준비됩니다

TmaxTibero publishes its JDBC driver on Maven Central with GPG signatures. tibero-mcp downloads that exact build once, refuses it if the checksum differs, and caches it. Nothing proprietary is stored in the repository, and you can point TIBERO_JDBC_JAR at a jar you already have. TmaxTibero는 JDBC 드라이버를 GPG 서명과 함께 Maven Central에 배포합니다. tibero-mcp는 정확히 그 빌드를 한 번 내려받고, 체크섬이 다르면 사용하지 않으며, 캐시해 둡니다. 저장소에는 독점 바이너리가 없고, 이미 가진 jar가 있다면 TIBERO_JDBC_JAR로 지정할 수 있습니다.

Artifact아티팩트
com.tmaxtibero:tbjdbc8:7.2.6
SHA-1
c0fa9b9b43afc8a4c18bdb89acd4d40d8a30bc81
Cache캐시
~/.cache/tibero-mcp
Verified with검증 환경
Tibero 6