cubrid-lab/cubrid-mcp-server
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
CUBRID データベース用のモデルコンテキストプロトコル(MCP)サーバー — LLM がスキーマを検査し、pycubrid 経由で読み取り専用のクエリを実行できるようにします.
概要
CUBRID 用のモデルコンテキストプロトコルサーバーで、LM がスキーマを安全に検査し、pycubrid 経由で読み取り専用のクエリを実行できるようにします。 スキーマメタデータは、読み取り専用MCPリソースとして公開されているため、クライアントはツールコールなしでスキーマのコンテキストを発見し、読むことができます。 リソースは、同じ読み取り専用のカタログクエリをツールとして再利用します。追加のデータアクセスや書き込み表面はありません。 どちらもreturn application/json を返します。 {table} の表名は URI-template マッチング によってパーセント保存されます。 未知のかシステムテーブルは、 リソース読み取りエラーを生成し、 説明 table ツールにマッチします。 サーバは、小さなセットを明示します。 — 再利用可能な、共通の検査タスクの出発点をガイドしました。 プロンプトは : クライアントに、既存の読み取り専用のツールが呼び出して、どのような順序で注文するかを示すテキストを返します。 それらはデータベースに触れず、SQLを実行したり、新しいデータアクセス面を追加したり、パスの任意の引数が不信なデータとして厳密に解釈され、処理されることはありません.
概要（AI 翻訳）
CUBRID 用のモデルコンテキストプロトコルサーバーで、LM がスキーマを安全に検査し、pycubrid 経由で読み取り専用のクエリを実行できるようにします。
実際のMCP stdioセッションのターミナル録画(デモ/mcp demo.py、デモ/record demo.shで録画)。
詳細はこちら
CUBRID または MCP に新しい? クイックスタートガイドに従ってください。 それは、 使い捨て可能なローカル CUBRID の実験室を始めて下さい、サンプル テーブルを準備し、専用にして下さい 読み取り専用のアカウントで、MCP クライアント (短い Python スクリプト) を接続し、実行します。 最初のクエリは、各結果が何を意味するかとクリーンアップする方法を示す。 セクション 以下は、設定、ツール、クライアントのセットアップに関するリファレンスです。
##特徴
| ツール | 概要 |
お問い合わせ
| [all_table_names | データベース内の全てのユーザテーブル |
| [filter_table_names | 表名から探す |
| [schema_definitions | コラムタイプ・無効性・デフォルト・主キー情報 |
| [describe_table | フルメタデータ: 列、主キー、インデックスを1つの呼び出しで |
| [list_indexes | 主要コラムとフラグの表のインデックス |
| [explain_query | [SELECT/[[WITH]の実行計画/トレース(CUBRID[SHOW TRACE経由)] |
| 【[T9]】 | 【[[T10]】1つ以上のテーブル |
このページは 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 |
|---|
インストール
uvx cubrid-mcp-server設定
{
"mcpServers": {
"cubrid": {
"command": "uvx",
"args": ["cubrid-mcp-server"],
"env": {
"CUBRID_HOST": "localhost",
"CUBRID_USER": "readonly_user",
"CUBRID_PASSWORD": "secret",
"CUBRID_DATABASE": "mydb"
}
}
}
}