适合谁
- 使用 AI 编码工具（如 Claude Code、Cursor、Codex、Gemini CLI）的开发人员。
- 希望确保生成的 PostgreSQL 代码现代、可靠且高效的人。
P
50FMRS · D
pg-aiguide 通过提供语义搜索和最佳实践技能，显著提升了 AI 编码工具生成 PostgreSQL 代码的质量。它适合需要高质量数据库代码的开发人员，但需要网络访问，且依赖外部服务。
pg-aiguide 帮助 AI 编程工具编写更好的 PostgreSQL 代码。它提供官方 PostgreSQL 手册的语义搜索（按版本感知）、AI 优化的最佳实践技能（自动用于 AI 代理），以及扩展生态文档（如 TimescaleDB）。可用作代理技能、公共 MCP 服务器或 Claude Code 插件。
工具能力
search_docs
统一搜索工具，支持跨多个文档源的语义（向量相似性）和关键词（BM25）搜索，包括 PostgreSQL、TimescaleDB 和 PostGIS 文档。
view_skill
提供精选的、有主见的 PostgreSQL 最佳实践技能，涵盖模式设计、索引策略、数据类型、数据完整性、命名约定、性能调优和现代功能。
安装接入
作为 Agent Skills 安装：运行 npx skills add timescale/pg-aiguide --skill postgres。作为 MCP 服务器，可将 https://mcp.tigerdata.com/docs 添加到客户端配置（例如 mcpServers JSON）。作为 Claude Code 插件：运行 claude plugin marketplace add timescale/pg-aiguide 和 claude plugin install pg@aiguide。
claude_desktop_config.json
{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}
选型与风险
不适合谁
- 需要直接数据库连接或执行查询的应用程序。
- 需要本地、离线运行的环境。
所需权限
- 作为远程 HTTP 服务器，它接收查询并返回文档。
- 作为技能，它可能被 AI 代理自动调用。
风险与副作用
- 公共服务器可能包含文档中的过时或不准确信息。
- 远程服务器暴露于网络风险。
- AI 代理可能生成看似合理但未经验证的代码。
常见排障
- 确保网络连接可到达 `mcp.tigerdata.com`。
- 检查客户端 MCP 配置中的 URL 是否正确。
- 对于技能，验证 `npx skills` 已安装且版本兼容。
- 对于 Claude Code 插件，确保使用支持的 Claude 版本。
使用场景
为 AI 编码代理提供深入的 PostgreSQL 知识，以生成更好的模式。
跨不同文档源搜索 PostgreSQL 相关文档。
通过最佳实践技能自动化最佳实践应用。
支持客户端
Claude Code完整支持
Cursor完整支持
VS Code完整支持
Codex完整支持
Gemini CLI完整支持
Windsurf完整支持