前言：传统数据库开发运维的效率痛点

做过数据库开发、DBA运维的同学应该都深有体会：日常排查SQL性能问题时，需要在代码IDE、数据库客户端、监控平台之间反复切换窗口。
想要分析一条慢查询，流程繁琐到崩溃：

1. 打开数据库客户端，查询表结构、索引信息并复制；
2. 粘贴到AI对话窗口，让大模型分析；
3. 手动执行explain获取执行计划，再次复制上传；
4. 模拟新增索引还得手动建表测试，改动后还要清理废弃索引。

多工具来回切换、大量复制粘贴，不仅拉长排障时间，还容易出现信息遗漏、操作失误。随着MCP（Model Context Protocol）协议普及，AI与数据库直连成为新趋势，电科金仓近期在Gitee开源KES MCP Server，打通Cursor、TRAE等AI开发工具与国产金仓KES数据库，用自然语言即可驱动数据库完成结构探查、SQL分析、健康巡检、索引仿真优化，彻底告别多工具切换痛点。

一、KES MCP Server是什么？整体架构与交互逻辑

KES MCP Server是部署在AI开发工具与金仓KES数据库之间的中间服务，作为标准MCP协议服务端，承接AI客户端的数据库操作请求，统一做权限校验、安全拦截，再对接KES数据库执行操作，最后将真实库数据返回给AI做分析。

1. 五层分层架构

从上层到下层完整分层，职责清晰：

1. AI客户端层：Cursor、TRAE等支持MCP协议的开发IDE；
2. 传输层：提供三种传输模式适配不同部署场景；
3. 核心服务与安全层：权限校验、SQL风险拦截、访问控制；
4. 分析能力层：封装9大标准化数据库工具；
5. KES数据库层：金仓V8R6及以上版本数据库。

2. 三种传输部署模式

适配本地开发、远程团队、企业集中部署三类场景：

传输模式	适用场景	优势
Stdio	本地单机开发	无需开放端口，客户端自动拉起服务，开箱即用
SSE	小规模远程访问	轻量远程连接，配置简单
Streamable HTTP	企业集中生产部署	支持HTTPS、反向代理、网络隔离，适配多团队共享

3. 安全双模式，解决AI直连数据库风险

数据库是企业核心数据资产，AI大模型直连数据库必须做好权限管控，KES MCP Server提供两种可自由切换的运行模式，兼顾安全与灵活性：

1. Restricted（受限模式，生产环境强制推荐）
   内置SQL语法白名单，仅放行SELECT、EXPLAIN、查询元数据等只读操作，自动拦截ALTER、DROP、INSERT、UPDATE等增删改高危语句，从源头阻断误删、篡改风险。
   最佳实践：单独创建仅具备查询权限的AI专用数据库账号，双层防护。
2. Unrestricted（无限制模式，仅测试环境使用）
   放开全部数据库操作权限，支持DDL、DML变更操作，适合测试环境调试、批量数据操作、库结构改造等场景。

二、四大核心能力，覆盖开发运维全场景

项目内置9套标准MCP工具，整合为四大核心能力，从库表查询、SQL性能、数据库巡检、索引仿真优化全覆盖，无需手动执行任何数据库命令。

1. 数据库结构全景探查

无需手动执行系统表查询、\d命令，自然语言直接读取真实库元数据：

• 批量查看所有Schema、数据表、视图、序列、扩展；
• 精准查询单表字段、主键、外键、普通索引、约束完整信息；
  自然语言示例：

列出public schema下所有表；查看orders表全部字段与索引详情。

2. SQL执行与执行计划智能分析

AI可直接基于真实数据库执行查询，自动抓取原生执行计划，精准定位扫描方式、索引失效、过滤逻辑等性能瓶颈：

• 按需生成业务查询并返回真实数据；
• 一键解析SQL执行计划，定位全表扫描、低效连接等问题；
  自然语言示例：

查询本月销售额前5的商品；分析这条订单SQL的执行计划，找出性能瓶颈。

3. 数据库一键健康诊断+慢查询定位

面向DBA运维场景，一句指令完成全维度数据库体检：

• 自动巡检索引、连接数、Vacuum、序列、复制、缓存、约束7大核心指标；
• 一键抓取系统中耗时最高的Top N慢SQL，快速锁定劣化查询；
  自然语言示例：

检查当前数据库整体健康状态；找出最近运行耗时最高的5条SQL。

4. 无损索引仿真优化（核心亮点）

依托金仓sys_hypo虚拟索引扩展，无需创建真实物理索引，就能模拟新增联合索引、单列索引后的执行计划变化：

• 针对单条SQL自定义索引方案，对比优化前后执行代价；
• 基于历史负载批量推荐最优索引组合；
  全程不占用磁盘存储、不增加写入维护开销，评估有效后再落地真实索引，大幅降低优化试错成本。
  自然语言示例：

在user_id、status字段新建联合索引，模拟查看执行计划变化。

三、完整实战：IDE内完成订单SQL全流程调优

以业务常见订单查询语句为例，演示从表结构查询→执行计划分析→索引仿真优化的完整闭环，全程无需切换工具：
测试SQL：

SELECT * FROM orders WHERE user_id = 123 AND status = 'pending';

1. 第一步：探查表结构
   输入指令：查看orders表字段、约束、现有索引
   MCP服务拉取真实库表信息，确认当前无user_id+status联合索引；
2. 第二步：分析原生执行计划
   输入指令：分析上面这条订单SQL的执行计划
   返回结果显示当前执行全表扫描，查询效率低下；
3. 第三步：仿真新增索引评估收益
   输入指令：模拟创建user_id和status联合索引，对比执行计划
   服务通过虚拟索引生成新执行计划，可见扫描方式从全表扫描转为索引扫描，查询代价大幅下降；
4. 落地决策
   结合业务写入压力、查询频次、存储成本，由DBA判断是否正式创建物理索引。

整套流程全部在Cursor、TRAE开发工具内完成，省去客户端切换、复制粘贴、临时建索引测试等冗余操作。

四、快速部署安装指南

环境前置要求

1. 数据库：KingbaseES V8R6及以上版本；
2. Python：3.12 ~ 3.13；
3. 客户端：Cursor、TRAE等支持MCP协议的AI开发IDE；
4. 可选扩展：索引仿真需sys_hypo，慢查询分析需sys_stat_statements。

1. 拉取开源代码

git clone shturl.cc/TiST3iI93AXp1QCCWXoJQtSWxbvi
cd kingbase-mcp

2. 安装项目依赖

uv pip install .

3. 启动服务（生产环境推荐受限模式）

uv run kingbase-mcp --access-mode restricted

本地Stdio模式无需手动启动，MCP客户端会自动拉起服务，仅需在IDE配置文件填写数据库连接参数即可。

五、总结与落地价值

1. 降本增效：统一IDE内完成数据库开发、SQL调优、运维巡检，消除多工具切换成本，大幅缩短慢SQL排障周期；
2. 国产信创适配：完全基于金仓KES国产数据库打造，适配政务、金融、央企等信创场景；
3. 安全可控：双运行模式+SQL白名单机制，解决AI直连数据库的数据安全顾虑；
4. 零成本索引验证：虚拟索引仿真功能，避免无效索引占用存储、拖慢写入性能；
5. 开源免费：项目在Gitee开源，MIT协议，开发者可自由部署、二次改造。

目前项目同步开启KES MCP Server主题征文活动，分享落地实践即可参与投稿赢取奖品，感兴趣的开发者可前往Gitee下载体验。