Skip to main content
PawSQL MCP 将 PawSQL 的 SQL 优化能力以 MCP 工具的形式提供给 AI 编程客户端。开发人员可以在对话中提交 SQL、补充 DDL 或指定工作空间,并获得查询重写、索引推荐、执行计划分析和性能评估结果。 PawSQL MCP 不是 IDE 插件,也不替代 PawSQL Cloud 或 PawSQL Server。它以远程 SSE 服务的形式启用,是 MCP 客户端与 PawSQL 服务之间的集成层。

工作方式

PawSQL MCP 返回的是分析与优化建议。不要授权 AI 客户端自动执行重写后的 SQL、CREATE INDEX 或其他数据库变更。

可以完成什么

  • 查询可用的 PawSQL 工作空间;
  • 在不使用工作空间时,按数据库类型快速分析 SQL;
  • 结合 DDL、索引和约束信息进行更准确的优化;
  • 使用现有工作空间的数据库上下文进行优化;
  • 获取 SQL 重写和索引优化建议;
  • 在连接数据库且允许验证的工作空间中分析执行计划;
  • 返回详细报告链接、分析环境和性能评估信息。
当前公开版本列出的数据库包括 MySQL、PostgreSQL、Oracle、KingbaseES、openGauss、MogDB、GaussDB 和 DWS。最终支持范围取决于 PawSQL MCP 与所连接 PawSQL 服务的版本。

选择优化模式

能使用正确的工作空间时,优先使用工作空间优化。无法访问数据库时,至少提供数据库类型、版本以及相关表的完整 DDL。

前提条件

  • 已有可访问的 PawSQL Cloud、PawSQL Server 或 PawSQL Community Edition;
  • 使用支持远程 SSE MCP 服务的 AI 编程工具;
  • 已从 PawSQL 管理员或服务提供方取得 MCP SSE 地址;
  • 已准备当前部署要求的认证信息;
  • 账号具有目标组织、项目和工作空间的访问权限;
  • 企业网络允许客户端通过 HTTPS 访问 PawSQL MCP SSE 服务。

配置 PawSQL MCP

1. 获取 SSE 连接信息

PawSQL MCP 只通过 SSE 形式提供服务。配置前,从管理员或 PawSQL 服务提供方取得以下信息:
不同 PawSQL Cloud、Server 和 Community Edition 部署的 SSE 地址可能不同。请使用实际环境提供的完整地址,不要根据示例推测端口或路径。

2. 在 MCP 客户端中添加远程服务

不同客户端的设置入口和字段名称不同。对于使用 mcpServers 配置远程 SSE 服务的客户端,结构通常如下:
<pawsql-mcp-sse-url> 替换为实际 SSE 地址。如果部署要求认证,请按照 PawSQL 管理员和目标客户端的说明配置凭据或请求头。
不要把包含真实 SSE 凭据、访问令牌或认证请求头的 MCP 配置提交到 Git、共享到聊天记录或写入项目模板。应使用客户端密钥存储或企业批准的秘密管理方案保护认证信息。

3. 重新加载客户端

1

保存配置

检查 JSON 语法、SSE 地址和认证配置。
2

重启或重新加载 MCP

让客户端重新读取配置并连接 PawSQL MCP SSE 服务。
3

检查工具发现结果

在客户端的 MCP 状态或工具列表中确认 PawSQL 已连接且工具可用。
4

执行脱敏测试

先使用非生产 SQL 验证数据库类型、工作空间识别和报告返回是否正常。

第一次优化 SQL

方式一:仅提供 SQL 和数据库类型

适用于快速检查。提示中应明确数据库产品,必要时补充版本。

方式二:同时提供 DDL

当无法使用工作空间时,提供相关表、索引和约束的完整定义。

方式三:指定工作空间

先让客户端列出可用工作空间,再通过名称或 ID 指定目标环境。
工作空间名称相似时,应使用工作空间 ID,并在调用前核对组织、项目、数据库类型和环境。不要根据名称猜测生产或测试环境。

阅读优化结果

建议按以下顺序审阅:
  1. 分析环境:确认数据库类型、版本、工作空间和 Schema;
  2. 对象识别:确认表、列、索引和约束没有被错误解析;
  3. SQL 重写:比较过滤条件、连接关系、聚合、排序、空值和重复行语义;
  4. 索引建议:检查与已有索引的重叠、列顺序、写入成本和存储成本;
  5. 执行计划:比较访问路径、连接方式、估算行数和代价;
  6. 性能评估:确认结果来自真实验证还是估算,并检查测试参数是否具有代表性;
  7. 详细报告:保留报告链接或导出结果,作为评审和回溯依据。

安全采用建议

1

验证语义等价性

使用边界值、空值、重复值和代表性业务数据比较原 SQL 与重写 SQL 的结果。
2

评估索引影响

检查重复索引、DML 开销、磁盘空间、锁等待和数据库特定的在线创建方式。
3

在非生产环境验证

使用接近生产的数据规模、参数分布和统计信息执行多轮测试。
4

完成变更评审

将 SQL 和索引变更纳入代码评审、数据库变更审批及回退计划。
5

受控发布并观察

发布后关注延迟、吞吐量、资源使用和执行计划是否出现回退。

常见问题

客户端没有发现 PawSQL 工具

检查 JSON 格式、配置文件位置、客户端是否支持远程 SSE MCP,以及配置保存后是否已经重新加载。

SSE 连接无法建立或频繁断开

确认 SSE URL 完整且使用正确协议,并检查 DNS、HTTPS 证书、代理、VPN、网关空闲超时和企业防火墙策略。不要用普通 PawSQL Web 地址替代 MCP SSE 地址。

无法连接 PawSQL 服务

核对 SSE 地址、HTTPS 证书、代理和网络访问策略。企业版还需确认客户端能够解析并访问内部域名。

认证失败

确认认证信息与 SSE 服务要求一致,并检查凭据有效期、账号状态和工作空间权限。不要在日志或支持工单中粘贴真实凭据。

找不到目标工作空间

检查账号的组织和项目成员关系、工作空间权限及工作空间状态。确认客户端连接的是创建该工作空间的 PawSQL 环境。

有优化建议,但没有执行计划或性能验证

执行计划分析和性能验证通常要求使用已连接数据库且启用了相应能力的工作空间。仅提供 SQL 或 DDL 时,结果主要来自静态分析。

建议使用了错误的数据库语法

重新提交请求并明确数据库产品、版本、Schema 或工作空间。若使用 DDL 模式,检查 DDL 是否完整且与当前环境一致。

与 IDE 插件的区别

下一步

工作空间与数据库上下文

查看优化建议

验证优化效果

开发工具集成概览

相关资源