用 Goose 扩展 PostgreSQL MCP Server让 AI Agent 以自然语言直接查询你的数据库【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goosePostgreSQL MCP 扩展通过 crates/goose 之上的扩展Extension机制把modelcontextprotocol/server-postgres这类 MCP 服务器接入 goose使 goose 能够直接对 PostgreSQL 实例执行只读的查询与元数据表结构分析并以自然语言与用户协作完成数据库探索任务。本文以 documentation/docs/mcp/postgres-mcp.md 为主线结合 goose 源码中的扩展配置实现完整讲解连接串格式、快速安装、交互式配置与安全要点读完即可在自己的本地或远程 PostgreSQL 上复现整个接入流程。这个扩展能做什么PostgreSQL MCP 扩展让 goose 直接与你的 PostgreSQL 数据库交互提供三类能力数据库操作Database operations数据查询Querying模式Schema管理信息查看它属于 MCP 生态中的一种服务端接入方式goose 作为 MCP 客户端通过标准输入输出stdio启动一个本地命令作为扩展二者以 JSON-RPC 交换工具Tool调用与结果。你只需用自然语言描述意图goose 会将其翻译为合适的 SQL 并返回结果。需要注意两点前提该扩展只支持只读操作你可以查询数据、获取表结构信息但无法修改数据库内容。官方文档在标题下方标注了 “Server archived”服务器已归档即modelcontextprotocol/server-postgres参考实现已被上游项目归档社区可能更倾向使用仍在维护的替代实现。不过本文描述的扩展配置模式命令 连接串 超时与所选 MCP 服务器无关对任何 stdio 型 PostgreSQL MCP 服务器都适用。前置条件运行npx命令需要你的系统已安装Node.js因为官方命令基于npx执行。goose 侧无需额外安装扩展通过 goose 的配置机制声明式接入。快速安装两条路路线一goose Desktop 一键安装在 goose Desktop 中点击下方启动器即可适用于 Desktop 界面——该链接实际是一个goose://extension协议链接浏览器或 Desktop 捕获后会自动填入扩展参数goose://extension?cmdnpxarg-yargmodelcontextprotocol/server-postgresargYour%20PostgreSQL%20connection%20URLidpostgresnamePostgreSQLdescriptionPostgreSQL%20database%20integration其中argYour%20PostgreSQL%20connection%20URL占位符需要替换为你 URL 编码后的真实连接串例如postgresql%3A%2F%2Flocalhost%2Fmydb。路线二goose CLI 一行命令在终端执行npx -y modelcontextprotocol/server-postgres postgresql://localhost/mydb-y表示自动确认 npm 包的下载安装该命令会把 MCP 服务器以 stdio 子进程方式启动并携带数据库连接串作为唯一参数。理解连接串Customizing Your Connection当前该 MCP 服务器一次只允许连接一个预先指定的数据库且连接 URL 必须写在命令里。官方以postgresql://localhost/mydb作为访问本地数据库的示例你可按自己的环境修改。PostgreSQL 连接 URL 遵循如下格式postgresql://username:passwordhostname:5432/database各字段含义字段含义示例username你的 PostgreSQL 用户myuserpassword你的 PostgreSQL 密码mypasshostnamePostgreSQL 所在主机localhost、IP 或域名db.example.com5432PostgreSQL 默认端口使用其他端口时需修改5433database目标数据库名mydb常见示例本地数据库postgresql://localhost/mydb带凭据的本地库postgresql://myuser:mypasslocalhost/mydb远程数据库postgresql://user:passdb.example.com:5432/production:::caution绝不把带凭据的连接串提交到版本控制应使用环境变量或安全的配置管理方式来保存连接信息。在 goose 的配置界面中你可以把敏感信息放进环境变量见下文“环境变量与凭据处理”由密钥环统一管理。 :::通过goose configure交互式配置如果你更希望把扩展写入 goose 的全局配置并命名管理可以使用 CLI 的交互式向导共 7 步1. 运行 configure 命令goose configure2. 选择添加 Command-line Extension┌ goose-configure │ ◇ What would you like to configure? │ Add Extension (Connect to a new extension) │ ◆ What type of extension would you like to add? │ ○ Built-in Extension │ ● Command-line Extension (Run a local command or script) │ ○ Remote Extension (Streamable HTTP) └3. 为扩展命名如 PostgreSQL┌ goose-configure │ ◇ What would you like to configure? │ Add Extension (Connect to a new extension) │ ◇ What type of extension would you like to add? │ Command-line Extension │ ◆ What would you like to call this extension? │ PostgreSQL └4. 输入带数据库连接 URL 的命令┌ goose-configure │ ... ◆ What command should be run? │ npx -y modelcontextprotocol/server-postgres postgresql://localhost/mydb └5. 设置超时时间默认 300 秒通常足够┌ goose-configure │ ... ◆ Please set the timeout for this tool (in secs): │ 300 └6. 选择是否添加描述若此处选择 “Yes”向导会继续提示你为该扩展输入一段描述文字。┌ goose-configure │ ... ◆ Would you like to add a description? │ No └7. 配置环境变量并完成┌ goose-configure │ ... ◆ Would you like to add environment variables? │ No └ Added PostgreSQL extension向导结束时会输出 “Added PostgreSQL extension”随后由 crates/goose-cli/src/commands/configure.rs 将配置持久化——该文件在保存后打印Extension settings saved successfully to {config.path()}Config::global()指向 goose 的全局配置用户也可以在之后直接编辑该配置文件来管理扩展条目。源码视角这条向导链路在 goose 内部如何运转上面的 CLI 向导并非“死页面”在仓库中有完整对应实现可帮助你理解每一步的校验规则与默认值。三种扩展类型的入口分发configure.rs 中的configure_extensions_dialog()先让用户选择扩展类型再分派到不同处理函数Built-in Extension内置扩展→configure_builtin_extension()Command-line Extension运行本地命令或脚本→configure_stdio_extension()Remote Extension (Streamable HTTP)→configure_streamable_http_extension()PostgreSQL 属于第二种stdio 本地命令型官方交互界面中对应的提示文案是 “Run a local command or script”。stdio 扩展的字段装配configure_stdio_extension()见 configure.rs按顺序收集扩展名 → 完整命令串 → 超时 → 描述 → 环境变量。其中命令串会通过goose::utils::split_command_args拆分为cmd与args两部分最终封装成ExtensionConfig::Stdio条目保存其字段包括name扩展名如PostgreSQLcmd/argsnpx与参数列表-y、包名、连接串description扩展描述timeout单次工具调用超时秒envs/env_keys注入的环境变量及其密钥环引用cwd、bundled、available_tools等扩展元数据而 stdio 服务器本身在 crates/goose-mcp 侧的 runner 中以子进程方式启动并做 JSON-RPC 桥接这与文档中“直接运行npx一条命令”的形态保持一致。默认超时 300 秒从何而来向导第 5 步的输入框占位值来自常量DEFAULT_EXTENSION_TIMEOUT 300见 crates/goose/src/config/extensions.rsprompt_extension_timeout()会把它作为默认值展示并要求输入能被解析为u64秒数否则提示 “Please enter a valid timeout”见 configure.rs。同时该默认值也支持通过环境变量覆盖仓库在 crates/goose/src/config/base.rs 中声明了GOOSE_DEFAULT_EXTENSION_TIMEOUT适合在自动化脚本或 CI 场景批量设置扩展超时而无需每次进入交互向导。命名与环境变量的安全处理prompt_extension_name()会校验名称非空且不与已有扩展重名collect_env_vars()见 configure.rs则用cliclack::password以掩码方式收集环境变量值并通过try_store_secret写入密钥环keyring而不是明文落盘——这正是文档提醒“连接串凭据不要提交到版本库”的最佳实践把password部分交给环境变量或密钥环配置文件里只留非敏感部分。使用示例用自然语言做数据分析接入完成后直接向 goose 描述你想做的事即可goose 会把它翻译成合适的 SQL 并执行。由于扩展只读你可以放心地用它了解库内信息而不必担心误改数据。goose Prompt示例查询Search my database for any students whose current GPA is higher than the average in their current grade level. Tell me their name, grade, and how much they exceed their grades average GPA, and the average GPA.goose Output示例输出Based on the query results, here are the students who are performing above their grade level average: Grade 11 Emma Johnson GPA: 4.00 Grade Average: 3.90 Exceeds average by: 0.10 points Grade 12 John Smith GPA: 3.85 Grade Average: 3.78 Exceeds average by: 0.08 points Both students are performing well above their respective grade level averages. Emma Johnson in Grade 11 shows the highest difference above the grade average, exceeding it by 0.10 points, while John Smith in Grade 12 exceeds his grades average by 0.08 points.这类“高于同年级平均 GPA 的学生”查询涉及分组聚合与子查询对比goose 会根据数据库真实表结构如表名、列名、主外键关系自动生成正确 SQL然后以自然语言归纳结果——这是该扩展最主要的落地场景用对话替代手写 SQL 来探索数据库。安全与使用建议结合文档警示与源码实现给出几条实操建议凭据隔离把username:password段通过环境变量配置向导第 7 步或密钥环注入连接串中只保留主机与库名避免配置文件落入版本控制。端口与主机默认端口是5432云数据库或容器化部署常使用自定义端口记得同步修改连接串。超时按需调整慢查询或大表聚合可能超过 300 秒默认值可在此次配置或后续编辑配置时调大反之追求快速失败可调小。只读边界该服务器实现仅提供只读查询能力若要执行写操作或 DDL需要另配具备写权限的工具切勿把高权限连接串交给不可信来源。服务已归档由于上游modelcontextprotocol/server-postgres已标记 archived生产使用可考虑仍在维护的同协议替代服务器——接入方式完全相同仍是命令 连接 URL 超时三段式配置。小结PostgreSQL MCP 扩展的接入本质上是 goose 扩展机制的典型样例一条npx命令 一个连接串即可把任何 stdio 型 MCP 服务器注册为 goose 的能力。无论通过 Desktop 深链、CLI 交互式goose configure还是直接编辑全局配置核心参数始终是扩展名、启动命令、超时与环境变量。理解了 configure.rs 中的装配逻辑后你完全可以把同样的模式复用到其他数据库或内部工具的 MCP 接入上。【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用 Goose 扩展 PostgreSQL MCP Server：让 AI Agent 以自然语言直接查询你的数据库
用 Goose 扩展 PostgreSQL MCP Server让 AI Agent 以自然语言直接查询你的数据库【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goosePostgreSQL MCP 扩展通过 crates/goose 之上的扩展Extension机制把modelcontextprotocol/server-postgres这类 MCP 服务器接入 goose使 goose 能够直接对 PostgreSQL 实例执行只读的查询与元数据表结构分析并以自然语言与用户协作完成数据库探索任务。本文以 documentation/docs/mcp/postgres-mcp.md 为主线结合 goose 源码中的扩展配置实现完整讲解连接串格式、快速安装、交互式配置与安全要点读完即可在自己的本地或远程 PostgreSQL 上复现整个接入流程。这个扩展能做什么PostgreSQL MCP 扩展让 goose 直接与你的 PostgreSQL 数据库交互提供三类能力数据库操作Database operations数据查询Querying模式Schema管理信息查看它属于 MCP 生态中的一种服务端接入方式goose 作为 MCP 客户端通过标准输入输出stdio启动一个本地命令作为扩展二者以 JSON-RPC 交换工具Tool调用与结果。你只需用自然语言描述意图goose 会将其翻译为合适的 SQL 并返回结果。需要注意两点前提该扩展只支持只读操作你可以查询数据、获取表结构信息但无法修改数据库内容。官方文档在标题下方标注了 “Server archived”服务器已归档即modelcontextprotocol/server-postgres参考实现已被上游项目归档社区可能更倾向使用仍在维护的替代实现。不过本文描述的扩展配置模式命令 连接串 超时与所选 MCP 服务器无关对任何 stdio 型 PostgreSQL MCP 服务器都适用。前置条件运行npx命令需要你的系统已安装Node.js因为官方命令基于npx执行。goose 侧无需额外安装扩展通过 goose 的配置机制声明式接入。快速安装两条路路线一goose Desktop 一键安装在 goose Desktop 中点击下方启动器即可适用于 Desktop 界面——该链接实际是一个goose://extension协议链接浏览器或 Desktop 捕获后会自动填入扩展参数goose://extension?cmdnpxarg-yargmodelcontextprotocol/server-postgresargYour%20PostgreSQL%20connection%20URLidpostgresnamePostgreSQLdescriptionPostgreSQL%20database%20integration其中argYour%20PostgreSQL%20connection%20URL占位符需要替换为你 URL 编码后的真实连接串例如postgresql%3A%2F%2Flocalhost%2Fmydb。路线二goose CLI 一行命令在终端执行npx -y modelcontextprotocol/server-postgres postgresql://localhost/mydb-y表示自动确认 npm 包的下载安装该命令会把 MCP 服务器以 stdio 子进程方式启动并携带数据库连接串作为唯一参数。理解连接串Customizing Your Connection当前该 MCP 服务器一次只允许连接一个预先指定的数据库且连接 URL 必须写在命令里。官方以postgresql://localhost/mydb作为访问本地数据库的示例你可按自己的环境修改。PostgreSQL 连接 URL 遵循如下格式postgresql://username:passwordhostname:5432/database各字段含义字段含义示例username你的 PostgreSQL 用户myuserpassword你的 PostgreSQL 密码mypasshostnamePostgreSQL 所在主机localhost、IP 或域名db.example.com5432PostgreSQL 默认端口使用其他端口时需修改5433database目标数据库名mydb常见示例本地数据库postgresql://localhost/mydb带凭据的本地库postgresql://myuser:mypasslocalhost/mydb远程数据库postgresql://user:passdb.example.com:5432/production:::caution绝不把带凭据的连接串提交到版本控制应使用环境变量或安全的配置管理方式来保存连接信息。在 goose 的配置界面中你可以把敏感信息放进环境变量见下文“环境变量与凭据处理”由密钥环统一管理。 :::通过goose configure交互式配置如果你更希望把扩展写入 goose 的全局配置并命名管理可以使用 CLI 的交互式向导共 7 步1. 运行 configure 命令goose configure2. 选择添加 Command-line Extension┌ goose-configure │ ◇ What would you like to configure? │ Add Extension (Connect to a new extension) │ ◆ What type of extension would you like to add? │ ○ Built-in Extension │ ● Command-line Extension (Run a local command or script) │ ○ Remote Extension (Streamable HTTP) └3. 为扩展命名如 PostgreSQL┌ goose-configure │ ◇ What would you like to configure? │ Add Extension (Connect to a new extension) │ ◇ What type of extension would you like to add? │ Command-line Extension │ ◆ What would you like to call this extension? │ PostgreSQL └4. 输入带数据库连接 URL 的命令┌ goose-configure │ ... ◆ What command should be run? │ npx -y modelcontextprotocol/server-postgres postgresql://localhost/mydb └5. 设置超时时间默认 300 秒通常足够┌ goose-configure │ ... ◆ Please set the timeout for this tool (in secs): │ 300 └6. 选择是否添加描述若此处选择 “Yes”向导会继续提示你为该扩展输入一段描述文字。┌ goose-configure │ ... ◆ Would you like to add a description? │ No └7. 配置环境变量并完成┌ goose-configure │ ... ◆ Would you like to add environment variables? │ No └ Added PostgreSQL extension向导结束时会输出 “Added PostgreSQL extension”随后由 crates/goose-cli/src/commands/configure.rs 将配置持久化——该文件在保存后打印Extension settings saved successfully to {config.path()}Config::global()指向 goose 的全局配置用户也可以在之后直接编辑该配置文件来管理扩展条目。源码视角这条向导链路在 goose 内部如何运转上面的 CLI 向导并非“死页面”在仓库中有完整对应实现可帮助你理解每一步的校验规则与默认值。三种扩展类型的入口分发configure.rs 中的configure_extensions_dialog()先让用户选择扩展类型再分派到不同处理函数Built-in Extension内置扩展→configure_builtin_extension()Command-line Extension运行本地命令或脚本→configure_stdio_extension()Remote Extension (Streamable HTTP)→configure_streamable_http_extension()PostgreSQL 属于第二种stdio 本地命令型官方交互界面中对应的提示文案是 “Run a local command or script”。stdio 扩展的字段装配configure_stdio_extension()见 configure.rs按顺序收集扩展名 → 完整命令串 → 超时 → 描述 → 环境变量。其中命令串会通过goose::utils::split_command_args拆分为cmd与args两部分最终封装成ExtensionConfig::Stdio条目保存其字段包括name扩展名如PostgreSQLcmd/argsnpx与参数列表-y、包名、连接串description扩展描述timeout单次工具调用超时秒envs/env_keys注入的环境变量及其密钥环引用cwd、bundled、available_tools等扩展元数据而 stdio 服务器本身在 crates/goose-mcp 侧的 runner 中以子进程方式启动并做 JSON-RPC 桥接这与文档中“直接运行npx一条命令”的形态保持一致。默认超时 300 秒从何而来向导第 5 步的输入框占位值来自常量DEFAULT_EXTENSION_TIMEOUT 300见 crates/goose/src/config/extensions.rsprompt_extension_timeout()会把它作为默认值展示并要求输入能被解析为u64秒数否则提示 “Please enter a valid timeout”见 configure.rs。同时该默认值也支持通过环境变量覆盖仓库在 crates/goose/src/config/base.rs 中声明了GOOSE_DEFAULT_EXTENSION_TIMEOUT适合在自动化脚本或 CI 场景批量设置扩展超时而无需每次进入交互向导。命名与环境变量的安全处理prompt_extension_name()会校验名称非空且不与已有扩展重名collect_env_vars()见 configure.rs则用cliclack::password以掩码方式收集环境变量值并通过try_store_secret写入密钥环keyring而不是明文落盘——这正是文档提醒“连接串凭据不要提交到版本库”的最佳实践把password部分交给环境变量或密钥环配置文件里只留非敏感部分。使用示例用自然语言做数据分析接入完成后直接向 goose 描述你想做的事即可goose 会把它翻译成合适的 SQL 并执行。由于扩展只读你可以放心地用它了解库内信息而不必担心误改数据。goose Prompt示例查询Search my database for any students whose current GPA is higher than the average in their current grade level. Tell me their name, grade, and how much they exceed their grades average GPA, and the average GPA.goose Output示例输出Based on the query results, here are the students who are performing above their grade level average: Grade 11 Emma Johnson GPA: 4.00 Grade Average: 3.90 Exceeds average by: 0.10 points Grade 12 John Smith GPA: 3.85 Grade Average: 3.78 Exceeds average by: 0.08 points Both students are performing well above their respective grade level averages. Emma Johnson in Grade 11 shows the highest difference above the grade average, exceeding it by 0.10 points, while John Smith in Grade 12 exceeds his grades average by 0.08 points.这类“高于同年级平均 GPA 的学生”查询涉及分组聚合与子查询对比goose 会根据数据库真实表结构如表名、列名、主外键关系自动生成正确 SQL然后以自然语言归纳结果——这是该扩展最主要的落地场景用对话替代手写 SQL 来探索数据库。安全与使用建议结合文档警示与源码实现给出几条实操建议凭据隔离把username:password段通过环境变量配置向导第 7 步或密钥环注入连接串中只保留主机与库名避免配置文件落入版本控制。端口与主机默认端口是5432云数据库或容器化部署常使用自定义端口记得同步修改连接串。超时按需调整慢查询或大表聚合可能超过 300 秒默认值可在此次配置或后续编辑配置时调大反之追求快速失败可调小。只读边界该服务器实现仅提供只读查询能力若要执行写操作或 DDL需要另配具备写权限的工具切勿把高权限连接串交给不可信来源。服务已归档由于上游modelcontextprotocol/server-postgres已标记 archived生产使用可考虑仍在维护的同协议替代服务器——接入方式完全相同仍是命令 连接 URL 超时三段式配置。小结PostgreSQL MCP 扩展的接入本质上是 goose 扩展机制的典型样例一条npx命令 一个连接串即可把任何 stdio 型 MCP 服务器注册为 goose 的能力。无论通过 Desktop 深链、CLI 交互式goose configure还是直接编辑全局配置核心参数始终是扩展名、启动命令、超时与环境变量。理解了 configure.rs 中的装配逻辑后你完全可以把同样的模式复用到其他数据库或内部工具的 MCP 接入上。【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考