cubrid-lab/cubrid-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

34 stars 37 forks Качество 86 Тренд 32MIT

Сервер Model Context Protocol (MCP) для базы данных CUBRID — позволяет LLM проверять схемы и выполнять запросы только для чтения через pycubrid.

Обзор

Сервер Model Context Protocol для CUBRID, позволяющий LLM безопасно проверять схемы и выполнять запросы только для чтения через pycubrid. Метаданные схемы также отображаются как MCP-ресурсы только для чтения, поэтому клиенты могут обнаруживать и читать контекст схемы без вызова инструмента. Ресурсы повторно используют те же запросы каталога только для чтения, что и инструменты, без дополнительного доступа к данным или записи. Оба возвращают заявку/json. Названия таблиц в таблице расшифровываются в процентах с помощью сопоставления URI-шаблонов; неизвестная или системная таблица создает ошибку чтения ресурсов, соответствующую инструменту description table. Сервер также предоставляет небольшой набор многоразовых исходных точек для общих задач проверки. Каждый возвращает текст, который сообщает клиенту, какой из существующих инструментов только для чтения позвонить и в каком порядке. Они никогда не прикасаются к базе данных, не выполняют SQL и не добавляют какую-либо новую поверхность доступа к данным, и любой аргумент, который вы передаете, огражден и рассматривается строго как ненадежные данные.

Обзор (машинный перевод)

Сервер Model Context Protocol для CUBRID, позволяющий LLM безопасно проверять схемы и выполнять запросы только для чтения через pycubrid.

Терминальная запись реального сеанса MCP stdio (demos/mcp demo.py, записанная с помощью demos/record demo.sh).

Начните здесь

Новый для CUBRID или MCP? Следуйте инструкциям быстрого старта. Это запускает одноразовую локальную лабораторию CUBRID, готовит образец таблицы и выделенный учетная запись только для чтения, подключает один клиент MCP (короткий скрипт Python) и запускает Первый запрос, показывающий, что означает каждый результат и как его очистить. Разделы Ниже приведены ссылки на конфигурацию, инструменты и настройку клиента.

Особенности

| Инструмент | Описание [скрыто] [скрыто] [скрыто] [скрыто] all_table_names Перечислите каждую таблицу пользователей в базе данных. | filter_table_names | Поиск подстроек по названиям таблиц | schema_definitions | Типы колонок, недействительность, дефолты и информация о первичном ключе | | describe_table | Полные метаданные: столбцы, первичный ключ и индексы в одном вызове | | list_indexes | Индексы для таблицы с ключевыми столбцами и флагами | [[Т5]] [[Т8]]] [[Т6]] [[Т7]] [[Т8]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [9] [10] для одной или нескольких таблиц

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

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"
      }
    }
  }
}