cubrid-lab/cubrid-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

34 stars 37 forks 품질 86 트렌드 32MIT

Repository Install

CUBRID 데이터베이스의 모델 콘텍스 프로토콜 (MCP) 서버 - pycubrid를 통해 읽기 전용 쿼리를 검사하기 위해 LLM을 가능하게 합니다.

개요

CUBRID에 대한 모델 콘텍스 프로토콜 서버는 LLM을 안전하게 스키마를 검사하고 pycubrid를 통해 읽기 전용 쿼리를 실행합니다. Schema metadata는 읽기 전용 MCP 리소스로 노출되므로 고객은 도구 통화없이 스키마 컨텍스트를 발견하고 읽을 수 있습니다. 리소스는 도구로 동일한 읽기 전용 카탈로그 쿼리를 재사용합니다. 추가 데이터 액세스 또는 서면 표면. 두 반환 application/json. {table}의 테이블 이름은 URI 템플릿 일치에 의해 퍼센트입니다. 알 수없는 또는 시스템 테이블은 설명 table 도구와 일치하는 리소스 읽기 오류를 생성합니다. 서버는 또한 작은 세트를 노출 - 재사용, 일반적인 검사 작업에 대한 시작점을 안내. Prompts는 다음과 같습니다 : 각 반환 텍스트는 기존의 읽기 전용 도구의 클라이언트를 호출하고 어떤 순서로. 데이터베이스를 결코 터치하지 않고 SQL을 실행하거나 새로운 데이터 액세스 표면을 추가하고 통과하는 모든 인수는 신뢰할 수없는 데이터로 엄격하게 처리됩니다.

개요(AI 번역)

CUBRID에 대한 모델 콘텍스 프로토콜 서버는 LLM을 안전하게 스키마를 검사하고 pycubrid를 통해 읽기 전용 쿼리를 실행합니다.

실제 MCP stdio 세션 ( 데모/mcp demo.py , 데모/record demo.sh )에 기록된.

여기에 시작

CUBRID 또는 MCP에 새로운? 빠른 시작 가이드를 따르십시오. · 일회용 지역 CUBRID 실험실을 시작하고 샘플 테이블과 전용을 준비하십시오. read-only 계정은 MCP 클라이언트 (짧은 파이썬 스크립트)를 연결하고 실행합니다. 첫 번째 쿼리, 각 결과가 어떻게 정리하는지 보여주는. 이 섹션 아래는 구성, 도구 및 클라이언트 설정에 대한 참조입니다.

특징

도구	설명
`all_table_names`	데이터베이스의 모든 사용자 테이블 일람
`filter_table_names`	테이블 이름의 서브스트링 검색
`schema_definitions`	란 유형, 무능, 기본, 기본 키 정보
`describe_table`	전체 메타데이터: 열, 1차 키, 1부스 인덱스
`list_indexes`	키 컬럼과 플래그로 테이블에 색인
`explain_query`	`SELECT`/[T7]] `SHOW TRACE`]])
`table_row_counts`	[T10]] 하나나 많은 테이블

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

cubrid-mcp-server

A Model Context Protocol server for CUBRID, enabling LLMs to safely inspect schemas and execute read-only queries via pycubrid.

Terminal recording of a real MCP stdio session (demos/mcp_demo.py, recorded with demos/record_demo.sh).

Start here

New to CUBRID or to MCP? Follow the Quick Start guide. It starts a disposable local CUBRID lab, prepares a sample table and a dedicated read-only account, connects one MCP client (a short Python script) and runs a first query, showing what each result means and how to clean up. The sections below are the reference for configuration, tools and client setup.

Features

Tool	Description
`all_table_names`	List every user table in the database
`filter_table_names`	Substring search over table names
`schema_definitions`	Column types, nullability, defaults, and primary key info
`describe_table`	Full metadata: columns, primary key, and indexes in one call
`list_indexes`	Indexes for a table with key columns and flags
`explain_query`	Execution plan/trace for a `SELECT`/`WITH` (via CUBRID `SHOW TRACE`)
`table_row_counts`	`COUNT(*)` for one or many tables
`list_serials`	CUBRID `SERIAL` sequences with current value and bounds
`list_class_hierarchy`	CUBRID `CLASS` inheritance relationships
`execute_query`	Run read-only SQL with automatic output truncation
`health_check`	Verify database connectivity on demand
`execute_write`	Run a single `INSERT`/`UPDATE`/`DELETE` in an atomic transaction (only registered when opt-in write mode is enabled)

Resources

Schema metadata is also exposed as read-only MCP Resources, so clients can discover and read schema context without a tool call. Resources reuse the same read-only catalog queries as the tools — no additional data access or write surface.

Resource URI	MIME type	Description

GitHub에서 전체 README 보기

설치

uvx cubrid-mcp-server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "cubrid": {
      "command": "uvx",
      "args": ["cubrid-mcp-server"],
      "env": {
        "CUBRID_HOST": "localhost",
        "CUBRID_USER": "readonly_user",
        "CUBRID_PASSWORD": "secret",
        "CUBRID_DATABASE": "mydb"
      }
    }
  }
}