你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
PostgreSQL 扩展可以在支持 AI 的主机中注册模型上下文协议（MCP）服务器定义。 通过此注册，主机可以发现 PostgreSQL 工具，以便进行连接管理、架构探索、查询执行和相关工作流，而无需手动配置每个工具。
如果想要了解 MCP 支持在扩展中的工作原理、当前支持哪些主机以及注册后哪些工具系列可用，请使用此页面。
先决条件
在依赖于 MCP 服务器之前，请确保具有以下功能：
- 安装在 Visual Studio Code 或 Cursor 中的 PostgreSQL 扩展。
- 在扩展中启用 Copilot/AI 功能（
pgsql.copilot.enable为true）。 设置 ID 在两个编辑器中保留其pgsql.copilot.*前缀;标签在 Cursor 中显示为 AI 。 - 如果您希望 MCP 工具能够快速连接到服务器，则至少需要一个已保存的连接配置文件。
- 公开 MCP 注册 API 的受支持主机。
了解 MCP 注册的工作原理
当以下所有内容均为 true 时，扩展会自动注册 MCP 服务器：
- 主机公开受支持的 MCP 注册 API。
- 该扩展可以从其语言服务检索有效的 MCP 服务器 URL 和持有者令牌。
- 已启用 Copilot 集成。
目前，代码路径显式支持：
- Visual Studio Code 1.102 及更高版本通过 MCP 服务器定义提供程序 API
- 通过 Cursor 的
registerServerMCP API 使用 Cursor
在Visual Studio Code中，扩展将服务器注册为 PostgreSQL MCP。 在 Cursor 中，它将服务器注册为 pgsql-mcp。
Important
该扩展目前尚未为需要你自行输入 MCP URL 和令牌的独立客户端提供手动复制粘贴的设置流程。 如果客户端不支持主机级发现或注册，请改用扩展的内置 AI 工作流。
为 MCP 工具准备连接配置文件
最有用的 MCP 流取决于保存的连接信息。
- 打开 连接和标识 ，并创建或更新主机要使用的连接配置文件。
- 在工作流需要的位置保存凭据。
- 在依赖于 MCP 的自动化之前，请验证是否可以从扩展连接到目标数据库。
这很重要，因为基于连接的 MCP 工具是从扩展的连接存储中解析目标配置，而不是从 AI 主机中的独立数据库配置中解析。
在受支持的主机中使用 MCP 工具
主机发现 PostgreSQL MCP 服务器后，可以调用扩展公开的工具图面。
| 工具系列 | 可提供哪些帮助 | 典型使用 |
|---|---|---|
| 列出连接配置文件 | 查找已保存的配置 | 连接前先找到正确的个人资料 |
| 连接到 PostgreSQL 数据库 | 从保存的配置文件打开数据库会话 | 在正确的服务器或数据库上启动任务 |
| 列出数据库 | 枚举已连接的服务器上的数据库 | 切换上下文或检查可用数据库 |
| 获取数据库对象 | 提取架构上下文 | 在提出后续问题之前，确定表、视图、函数和其他对象 |
| 运行查询 | 执行面向读取的 SQL | 检查数据或验证假设 |
| 修改数据库 | 执行数据或架构更改 | 在需要写入访问权限的工作流中应用 DDL 或 DML |
| 打开 SQL 脚本 | 创建脚本以供审阅 | 从代理输出移动到人工评审的查询编辑器流 |
| 查询计划 | 检查缓存的计划数据 | 分析性能工作流 |
| 可视化数据库架构 | 呈现架构视图 | 在编写或更改 SQL 之前了解关系 |
| 获取仪表板上下文 | 检索活动仪表板会话上下文，包括可用的指标和配置 | 在请求指标数据之前发现哪些指标可用 |
| 获取仪表板指标数据 | 从打开的服务器仪表板提取批处理缓存的时序数据 | 在不运行实时查询的情况下分析服务器性能趋势 |
Tip
对于更安全的工作流，请先使用发现工具，例如 列表连接配置文件、 连接到 PostgreSQL 数据库，以及在运行查询或修改之前 获取数据库对象 。
在 MCP 与内置 AI 体验之间进行选择
如果主机支持 MCP 发现，并且希望扩展在其中公开其 PostgreSQL 工具图面，请使用 MCP 服务器。
在以下情况下使用内置扩展体验：
- 你希望直接与 @pgsql 聊天参与者 对话（仅限 Visual Studio Code），
- 您想要在代理模式（Visual Studio Code 和 Cursor）中进行多步自动化操作，或者
- 你当前使用的主机不会自动显示该扩展的 MCP 注册信息。
MCP 可用性疑难解答
主机不显示 PostgreSQL MCP 服务器
确认正在运行受支持的主机，并在扩展中启用了Copilot/AI 集成。 如果需要，在登录或更改Copilot/AI 设置后重新加载窗口。
跳过注册
当扩展无法从语言服务检索可用 MCP URL 或令牌时，该扩展将跳过注册。 如果主机在重新加载后从未发现服务器，请检查扩展输出日志。
工具无法连接到我的数据库
验证目标连接配置文件是否存在，并且扩展是否可以直接使用它。 MCP 流依赖于与扩展的其余部分相同的连接存储和凭据解析。
我需要为另一个 MCP 客户端提供一个手动端点
该扩展当前尚未为独立的 MCP 客户端提供面向用户的手动端点工作流。 使用受支持的宿主，或退回到此文档集中介绍的内置 AI 功能。