AI操作数据库：KES MCP Server 完整实操教程

AI操作数据库KES MCP Server 完整实操教程一、什么是KES MCP Server1. 核心定义KES MCP Server是电科金仓基于MCPModel Context Protocol标准推出的数据库AI中间件部署在AI开发工具Cursor/TRAE与金仓KES数据库之间内置9套标准化数据库工具让大模型直接操作真实KES数据库无需手动切换数据库客户端、复制表结构/执行计划一站式完成库表查看、SQL分析、慢查询排查、索引仿真优化全流程工作。2. 分层架构与交互流程整体分为5层AI客户端层→传输层→核心服务安全层→分析能力层→KES数据库层用户在Cursor/TRAE输入自然语言指令AI客户端通过Stdio/SSE/Streamable HTTP将请求发给KES MCP ServerServer校验访问权限、拦截高危SQL连接KES执行操作数据库原始数据回传给AI模型自动分析给出优化方案全程AI无法直连数据库所有操作受MCP权限管控。3. 三大传输模式按需选择传输方式适用场景特点Stdio本地个人开发无需开放端口客户端自动拉起服务调试首选SSE小规模远程调试轻量长连接适合内网多机器共用Streamable HTTP企业生产/集中部署支持HTTPS、反向代理、网络隔离生产环境推荐4. 双安全运行模式核心安全能力Restricted受限模式生产必用内置SQL白名单仅允许SELECT、查询元数据、查看执行计划等只读操作拦截DELETE/ALTER/DROP等DDL/DML修改语句搭配AI专用最小权限账号彻底规避AI误删、改数据风险。Unrestricted无限制模式仅测试环境放开全部数据库操作权限支持建表、改索引、数据写入仅本地测试使用严禁线上开启。二、前置环境准备硬件软件要求数据库KES V8R6及以上版本Python3.12 ~ 3.13包管理工具uv推荐项目官方指定AI编辑器Cursor / TRAE支持MCP协议可选扩展增强功能sys_stat_statements慢查询、SQL负载统计sys_hypo仿真索引无需真实创建模拟索引优化效果环境初始化安装uv包管理器# Windows/macOS/Linux通用pipinstalluv提前创建KES专用AI账号最小权限-- 生产环境专用只读账号CREATEUSERai_mcpWITHPASSWORD自定义强密码;GRANTSELECTONALLTABLESINSCHEMApublicTOai_mcp;GRANTUSAGEONSCHEMApublicTOai_mcp;-- 禁止赋予修改、删除权限REVOKECREATE,ALTER,DROPONSCHEMApublicFROMai_mcp;三、KES MCP Server 完整安装部署步骤1拉取官方开源代码Gitee# 克隆项目仓库gitclone https://gitee.com/king-db/kingbase-mcp# 进入项目目录cdkingbase-mcp步骤2安装项目全部依赖uv pipinstall.步骤3启动服务两种方式方式1本地Stdio模式开发首选Restricted安全模式生产环境强制受限模式数据库连接通过环境变量注入# Linux/macOSexportDB_HOST127.0.0.1exportDB_PORT54321exportDB_NAME业务库名exportDB_USERai_mcpexportDB_PASSWORD你的数据库密码# 启动受限模式服务uv run kingbase-mcp --access-mode restricted# Windows PowerShell$env:DB_HOST127.0.0.1$env:DB_PORT54321$env:DB_NAME业务库名$env:DB_USERai_mcp$env:DB_PASSWORD你的数据库密码uv run kingbase-mcp--access-mode restricted方式2远程HTTP部署企业多团队共用# 指定Streamable HTTP传输开放端口3000exportTRANSPORTstreamable_httpexportMCP_PORT3000uv run kingbase-mcp --access-mode restricted四、AI编辑器MCP客户端配置方案1Cursor编辑器配置Windows/macOS找到MCP配置文件Windows%USERPROFILE%\.cursor\mcp.jsonmacOS~/.cursor/mcp.json写入Stdio本地配置最常用{mcpServers:{kes-mcp:{command:uv,args:[--directory,/你的kingbase-mcp项目绝对路径,run,kingbase-mcp,--access-mode,restricted],env:{DB_HOST:127.0.0.1,DB_PORT:54321,DB_NAME:业务库,DB_USER:ai_mcp,DB_PASSWORD:数据库密码}}}}保存文件完全关闭Cursor后重新打开编辑器自动拉起KES MCP服务并加载全部数据库工具。方案2TRAE编辑器配置在项目根目录创建.trae/mcp.json配置内容{servers:[{name:kes-mcp,command:uv,args:[--directory,/kingbase-mcp完整路径,run,kingbase-mcp,--access-mode,restricted],transport:stdio,env:{DB_HOST:127.0.0.1,DB_PORT:54321,DB_NAME:业务库,DB_USER:ai_mcp,DB_PASSWORD:数据库密码}}]}重启TRAEMCP面板识别KES数据库工具。五、KES MCP四大核心能力实战案例能力1数据库结构一键探查无需手动执行\d、查询系统表自然语言直接获取表、字段、索引、约束。常用指令示例列出public下所有表、视图、序列查看orders表全部字段、主键、普通索引、外键约束查询当前库所有schema及自定义扩展。能力2SQL执行与执行计划分析AI可直接生成业务SQL、执行查询、抓取真实执行计划定位慢SQL。指令示例查询本月订单销售额TOP5商品分析这条SELECT * FROM orders WHERE user_id123 AND statuspending’的执行计划说明扫描方式和索引使用情况。能力3数据库健康巡检慢SQL定位一站式运维体检自动检测索引失效、长连接、Vacuum堆积、复制延迟、缓存命中率。指令示例对当前KES数据库做全量健康检查输出风险点找出近一小时总耗时最高的5条慢查询。能力4索引仿真优化核心亮点依托sys_hypo扩展不创建真实物理索引模拟新增联合索引后的执行计划零成本评估索引收益。完整实战流程订单SQL优化全演示场景订单查询全表扫描优化联合索引第一步查看表结构输入指令查看orders表的字段、约束、现有全部索引MCP自动拉取元数据AI判断当前无user_idstatus联合索引查询会全表扫描。第二步分析原始SQL执行计划输入指令分析SQLSELECT * FROM orders WHERE user_id 123 AND status pending 的执行计划返回计划显示Seq Scan全表扫描查询代价极高。第三步仿真新增联合索引验证效果输入指令模拟在orders表user_id、status字段创建联合索引对比新执行计划MCP通过虚拟索引重新生成执行计划可见切换为Index Scan查询代价大幅下降。第四步落地变更仿真确认优化有效后由DBA手动执行CREATE INDEX语句避免盲目建索引浪费存储、增加写入压力。六、安全最佳实践生产环境必看强制Restricted受限模式线上禁止Unrestricted单独创建AI专用数据库账号仅分配SELECT只读权限不授予DDL/DML修改权限远程部署使用Streamable HTTPHTTPS反向代理关闭公网直接访问数据库端口定期清理慢查询日志限制MCP单次查询返回数据行数防止大表全量导出内网环境使用Stdio/SSE禁止MCP服务暴露公网敏感业务库单独部署MCP实例与测试环境隔离。七、常见问题排查编辑器识别不到MCP工具检查uv路径、项目目录填写绝对路径确认Python版本3.12~3.13依赖安装完整完全重启Cursor/TRAE不要仅刷新窗口。数据库连接失败核对DB_HOST、端口、库名、账号密码检查KES防火墙放行端口账号本地/远程登录权限确认KES版本≥V8R6。仿真索引功能无法使用登录KES执行CREATE EXTENSION IF NOT EXISTS sys_hypo;安装扩展慢查询统计无数据开启sys_stat_statements扩展修改数据库postgresql.conf配置启用统计采集。八、总结KES MCP Server打通AI开发工具与国产金仓数据库彻底解决开发人员多工具来回切换、SQL优化繁琐的痛点一套标准工具覆盖开发、DBA运维场景。配合严格的访问权限管控在保障数据安全的前提下大幅提升SQL调优、数据库巡检效率是适配国产数据库的AI原生解决方案。体验拓展参与电科金仓KES MCP Server主题征文活动分享落地实践可参与奖品评选。项目完整参数、高级配置可查阅Gitee仓库README文档。