GaussDB-MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| test_connectionA | 测试 GaussDB 连接,返回数据库版本、当前库、当前用户与服务器时间 |
| queryA | 在 GaussDB 上执行只读查询(SELECT/WITH/EXPLAIN/SHOW/VALUES 开头,单语句,写语句会被拒绝)并返回结果行。支持 limit/offset 截断返回(不修改 SQL 本身),可选 tx_handle 在事务内执行 |
| executeB | 执行任意 SQL(INSERT/UPDATE/DELETE/DDL 等),返回受影响行数。可选 tx_handle 在事务内执行。危险操作(DROP/TRUNCATE/DELETE)请谨慎 |
| insert_rowsA | 参数化批量插入:指定表名与行数组(对象数组,键为列名),可选 schema(缺省 public) |
| update_rowsA | 参数化更新:指定表名、SET(列→新值)与 WHERE(列→值,AND 连接,必填防全表误更新),可选 schema |
| delete_rowsA | 参数化删除:指定表名与 WHERE(列→值,AND 连接,必填防全表误删除),可选 schema |
| transaction_beginA | 开启 GaussDB 事务,返回事务句柄 tx_handle。后续 query/execute/写入工具可传入该句柄在同一事务内执行。空闲 5 分钟自动回滚回收 |
| transaction_commitA | 提交事务。需提供 transaction_begin 返回的句柄 |
| transaction_rollbackB | 回滚事务。需提供 transaction_begin 返回的句柄 |
| list_databasesA | 列出 GaussDB 实例中所有可连接的数据库及大小 |
| list_schemasA | 列出当前数据库的所有 schema(排除系统 schema);配置白名单后仅列出允许的 schema |
| list_tablesA | 列出当前数据库的所有表及大小,可选按 schema 过滤 |
| describe_tableA | 查看表结构:列名、数据类型、长度、可空、默认值、是否主键 |
| list_indexesA | 列出索引及所属表,可选按 schema 过滤 |
| list_viewsA | 列出视图,可选按 schema 过滤 |
| list_sequencesB | 列出序列,可选按 schema 过滤 |
| explain_queryA | 查看 SQL 执行计划。analyze=true 时真实执行并统计耗时(自动包裹事务回滚,写语句不落盘) |
| list_sessionsB | 查看当前活跃会话(pg_stat_activity) |
| list_lock_conflictsA | 查看当前锁冲突:被阻塞会话与阻塞来源 |
| database_statsA | 查看数据库统计:版本、大小、连接数、当前用户、服务器地址与时间 |
| list_usersA | 列出数据库用户及属性 |
| create_userB | 创建可登录的数据库用户 |
| grant_privilegeB | 授予权限。privilege 示例:SELECT ON TABLE t、ALL PRIVILEGES ON DATABASE d、USAGE ON SCHEMA s |
| revoke_privilegeC | 回收权限。privilege 格式同 grant_privilege |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
大部分工具以资源类型清晰区分，list_*、query/execute、insert/update/delete_rows、事务三件套等边界明确。但 test_connection 与 database_stats 在返回版本、当前用户、时间等信息上存在重叠，可能造成轻微混淆。
整体采用蛇形命名，且以动词开头为主，如 list_tables、create_user、grant_privilege、delete_rows。但 database_stats、query、execute、transaction_begin 等少量工具偏离 verb_noun 模式，存在轻微不一致。
24 个工具落在 16-25 的偏重区间，虽然每个工具都有明确用途，但元数据浏览、写操作、事务控制、权限管理等维度拆分较细，整体数量感觉偏多，仍有合并空间。
覆盖了查询、写入、批量操作、事务、权限、元数据与监控，核心数据库操作较为完整。但用户管理仅有 create_user 而无 alter/drop_user，表级 DDL 也主要依赖通用 execute，存在可通过 execute 弥补的轻微生命周期缺口。