YeomYuJun/tibero-mcp-server

Tibero MCP Server

Tibero 데이터베이스와 AI 어플리케이션 간의 안전한 통신을 제공하는 Model Context Protocol(MCP) 서버입니다.

참고 사항

기존 타 DB의 MCP를 참고하여 재구성한 MCP입니다. 실제 사용 시 SELECT 이외에는 유의해야합니다.

주요 기능

• 리소스 제공: 데이터베이스 테이블과 뷰를 MCP 리소스로 노출
• SQL 실행: SELECT, INSERT, UPDATE, DELETE, DDL 쿼리 실행
• 스키마 정보: 테이블 구조, 제약조건, 인덱스 정보 조회
• 샘플 데이터: 테이블당 최대 100행의 샘플 데이터 제공

필요 환경

• Python 3.11+
• Java Runtime Environment 8+
• Tibero JDBC 드라이버 (tibero6-jdbc.jar) (*drivers 내부에 탑재 필요)

설치

pip install -r requirements.txt

Claude Desktop 설정

claude_desktop_config.json 파일에 추가:

{
  "mcpServers": {
    "tibero": {
      "command": "python",
      "args": ["/path/to/tibero_mcp_server/src/tibero_mcp_server/server.py"],
      "env": {
        "TIBERO_HOST": "localhost",
        "TIBERO_PORT": "8629",
        "TIBERO_SID": "tibero",
        "TIBERO_USER": "username",
        "TIBERO_PASSWORD": "password",
        "CLASSPATH": "/path/to/tibero6-jdbc.jar"
      }
    }
  }
}

제공 기능

1. 리소스 (Resources)

• 테이블: tibero://TABLE_NAME/data - 테이블 스키마 + 샘플 데이터 (최대 100행)
• 뷰: tibero://VIEW_NAME/view - 뷰 스키마 + 샘플 데이터

2. 도구 (Tools)

execute_sql

SQL 쿼리를 실행합니다.

• SELECT/SHOW/DESC: CSV 형태 결과 반환
• INSERT/UPDATE/DELETE: 영향받은 행 수 반환, 명시적 커밋
• DDL: 실행 결과 반환

get_table_info

테이블 상세 정보를 조회합니다.

• 컬럼 정보 (이름, 타입, 길이, NULL 허용)
• 제약조건 (PRIMARY KEY, UNIQUE, FOREIGN KEY, CHECK)
• 인덱스 정보 (이름, 유니크 여부)

실행

# 직접 실행
python src/tibero_mcp_server/server.py

# 모듈로 실행
python -m tibero_mcp_server.server

데이터베이스 연결

jaydebeapi를 사용하여 Tibero JDBC 드라이버로 연결합니다. DML 쿼리 실행 후 명시적으로 commit하며, 안전을 위해 AutoCommit=False로 설정됩니다.