1. 为什么 MCP-PostgreSQL-Ops 接进 CodeBuddy 后自然语言查询会卡住MCP-PostgreSQL-Ops 是一个基于 MCP 协议的 PostgreSQL 只读运维服务器它把服务器信息、活跃连接、表膨胀、锁等待、WAL、复制延迟这些指标封装成 38 个工具让 AI 助手用自然语言就能查。适合 DBA、后端开发和运维同学尤其是手上有一台本地或只读测试 PostgreSQL、想少写 SQL 快速看状态的人。但很多人第一次在 CodeBuddy 里接它会遇到一个很迷惑的现象MCP 服务明明启动了工具列表也刷出来了可你问「哪些表需要 VACUUM 维护」时AI 要么答非所问要么干脆不调用工具。我实测下来问题基本不在 MCP-PostgreSQL-Ops 本身而在两层配置被混在一起了。第一层是 MCP 启动层也就是mcpServers.command指向哪个 Python、args怎么传、env里的POSTGRES_HOST等连接参数对不对第二层是模型通道层也就是 CodeBuddy 里负责理解自然语言、决定调用哪个 MCP 工具的那个模型它的 Base URL 和 Key 有没有配通。原文从uv run切到本地 venv 的 python 路径解决的是第一层而真正消耗 Token、负责编排工具调用的模型通道如果没接好你的自然语言请求根本发不出去38 个工具就只是列表里的摆设。这篇就按「接入配置」这个槽位把 CodeBuddy 的模型通道改到 TaoToken同时保持 MCP-PostgreSQL-Ops 的数据库连接参数不动让你能稳定地用自然语言驱动那 38 个只读工具。2. 先分清两层MCP 启动层和模型通道层在动手改配置前先把职责划清楚不然很容易改错地方。MCP 启动层由mcpServers这一段决定。它管的是用哪个 Python 解释器启动mcp_postgresql_ops这个模块以及连哪个 PostgreSQL。原文里因为 Python 环境问题把command从uv换成了/Users/monkey/Downloads/codebuddy/mcp-venv/bin/pythonargs保留[-m, mcp_postgresql_ops]这是完全正确的做法。env里的POSTGRES_HOST、POSTGRES_PORT、POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB继续指向你自己的本地或只读测试库不要动。模型通道层在 CodeBuddy 的模型 Provider 设置里。它管的是CodeBuddy 用哪个模型来理解你的中文问题、规划要调用哪些 MCP 工具、把工具返回的 JSON 整理成人话。这一层需要 Base URL 和 API Key。TaoToken 只出现在这一层它不替代 MCP-PostgreSQL-Ops 去分析表膨胀、锁或复制延迟那些活还是 MCP 工具干的。注意把这两层分开看是排障的关键。MCP 工具列表能刷出来只证明启动层通了自然语言问不出结果大概率是模型通道层没配好。3. 拿到模型通道的 Key 并填进 CodeBuddy先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建账号并生成一个 API Key。这个 Key 是给 CodeBuddy 的模型通道用的跟你的 PostgreSQL 密码没有任何关系别混。生成 Key 的入口在控制台的 API Keys 页面路径是 https://taotoken.net/api-keys 登录后新建一个即可。拿到形如sk-开头的字符串后回到 CodeBuddy 的模型 Provider 设置Base URL 填https://taotoken.net/apiAPI Key 填刚生成的那串模型名按你实际要用的填CodeBuddy 里通常有下拉或手填这里有个容易踩的坑Base URL 末尾不要自己加/v1或/chat/completions填到https://taotoken.net/api这一层就行剩下的路径由客户端拼。填多了会 404填少了会连不上。配好之后CodeBuddy 的模型请求就会走 TaoToken 这条通道。你可以先在模型对话里发一句普通问题确认模型本身能回再去测 MCP 工具调用。模型对话入口在 https://taotoken.net/models 可以用来快速验证 Key 是否有效。4. 可复制的 CodeBuddy MCP 配置模型通道配好后MCP 启动层保持你原来的写法。下面这份是可直接抄的mcpServers配置把路径和数据库参数换成你自己的{ mcpServers: { mcp-postgresql-ops: { command: /Users/monkey/Downloads/codebuddy/mcp-venv/bin/python, args: [ -m, mcp_postgresql_ops ], env: { POSTGRES_HOST: 127.0.0.1, POSTGRES_PORT: 5432, POSTGRES_USER: your_user, POSTGRES_PASSWORD: your_password, POSTGRES_DB: your_dbname }, disabled: false } } }几个参数的含义对照一下字段作用注意点command启动 MCP 的 Python 解释器用 venv 里的绝对路径别用系统 pythonargs传给解释器的模块参数固定-m mcp_postgresql_opsPOSTGRES_HOST数据库地址本地填 127.0.0.1远程填实际 IPPOSTGRES_PORT数据库端口默认 5432容器映射可能是 15432POSTGRES_USER连接用户建议用只读普通用户POSTGRES_PASSWORD连接密码只读测试库的密码POSTGRES_DB默认数据库填你要监控的库名如果你还没装 MCP-PostgreSQL-Ops先在 venv 里装python -m venv /Users/monkey/Downloads/codebuddy/mcp-venv /Users/monkey/Downloads/codebuddy/mcp-venv/bin/pip install mcp-postgresql-ops装完可以用下面这条命令单独验证 MCP 能不能起来能起来会进入等待 stdio 输入的状态按 CtrlC 退出即可/Users/monkey/Downloads/codebuddy/mcp-venv/bin/python -m mcp_postgresql_ops5. 验证38 个工具和自然语言查询配置保存后重启 CodeBuddy打开 MCP 面板应该能看到mcp-postgresql-ops处于已连接状态工具数量显示 38 个。这一步只证明启动层通了。接着测模型通道和工具编排。在 CodeBuddy 对话框里依次问分析所有数据库的表膨胀哪些表需要 VACUUM 维护显示最耗时的 10 个查询检查复制延迟状态正常情况下你会看到 CodeBuddy 先调用get_table_bloat_analysis、get_vacuum_analyze_stats、get_pg_stat_statements_top_queries、get_replication_status这类工具再把返回的指标整理成中文。如果工具被调用了、返回了数据说明模型通道和 MCP 启动层都通了。提示get_pg_stat_statements_top_queries依赖pg_stat_statements扩展没装扩展时这个工具会返回提示而不是报错属于预期行为。表膨胀和 VACUUM 相关工具不依赖扩展可以先拿它们验证。6. 本篇常见错排查工具列表是空的或者一直转圈。先看command路径是否存在用ls确认那个 python 文件在。再看 venv 里有没有装mcp-postgresql-ops缺了就在 venv 里补装。路径里有空格或中文也可能导致启动失败。工具列表有 38 个但提问后 AI 不调用工具。这基本是模型通道层的问题。检查 Base URL 是不是https://taotoken.net/apiKey 有没有多余空格模型名是否可用。可以先去模型对话里发一句普通问题确认模型能回再回来测工具调用。提问后报连接数据库失败。这是 MCP 启动层的env问题跟 TaoToken 无关。确认POSTGRES_HOST、POSTGRES_PORT能从你机器上连通用psql或nc测一下端口。容器映射的端口经常和默认 5432 不一致别填错。返回结果里字段看不懂。MCP 工具返回的是原始指标 JSON模型负责翻译。如果模型通道用的是能力较弱的模型翻译质量会差。换一个理解能力更好的模型再试。改了配置不生效。CodeBuddy 有时需要完全退出再启动而不只是重开窗口。改完mcpServers和模型 Provider 后彻底重启一次。7. 把模型通道固定下来长期用 Coding Plan 更省心如果你只是偶尔查一下数据库状态按上面的方式配好 Key 就够用了。但如果你打算把 CodeBuddy 加 MCP-PostgreSQL-Ops 当成日常运维入口每天都要问表膨胀、慢查询、锁等待那模型通道的调用量会稳定上升这时候可以看看 Coding Plan路径是 https://taotoken.net/coding-plan 适合长期编码和 Agent 类场景把额度固定下来比每次临时充更省事。接入文档在 https://taotoken.net/doc 里面有 Base URL、鉴权和常见客户端的配置示例遇到路径拼接问题可以先翻这里。API Keys 管理在 https://taotoken.net/api-keys Key 泄露或换机器时在这里重新生成。最后提醒一句TaoToken 只负责模型通道PostgreSQL 的连接参数、只读权限、扩展安装这些还是你自己的事。把两层分清楚38 个只读工具才能真正被自然语言驱动起来。