pg-aiguide

环境要求

• 已安装并登录支持的 AI 编程工具（Claude Code、Codex、Cursor、Gemini CLI、VS Code、Windsurf、OpenCode
• 网络可访问公共 MCP 端点 https://mcp.tigerdata.com/docs
• 使用 Agent Skills 方式需支持 npx skills 的环境
• Cursor / Windsurf / OpenCode 需能编辑对应的 JSON 配置文件

安装与启动步骤

1. 1Claude Code 安装插件

   README 说明本仓库是 Claude Code 市场插件，用两条命令添加市场并安装 pg@aiguide；插件会使用 skills 目录技能和托管 MCP。

   claude plugin marketplace add timescale/pg-aiguide
   claude plugin install pg@aiguide

   复制

2. 2Codex 添加 MCP

   为 Codex 添加名为 pg-aiguide 的远程 MCP 服务，地址为 TigerData 托管的公共端点。

   codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide

   复制

3. 3Gemini CLI 添加 MCP

   使用 -s user 写入用户级配置，-t http 指定传输类型为 http。

   gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http

   复制

4. 4VS Code 添加 MCP

   用 code 命令一键写入 MCP 配置；VS Code Insiders 把命令换成 code-insiders 即可。

   code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

   复制

5. 5Cursor 配置 MCP

   在项目根目录 .cursor/mcp.json 中写入 mcpServers 配置，也可使用官方一键安装入口。

   {
     "mcpServers": {
       "pg-aiguide": {
         "url": "https://mcp.tigerdata.com/docs"
       }
     }
   }

   复制

6. 6Windsurf 配置 MCP

   编辑 ~/.codeium/windsurf/mcp_config.json，注意 Windsurf 使用的字段名是 serverUrl。

   {
     "mcpServers": {
       "pg-aiguide": {
         "serverUrl": "https://mcp.tigerdata.com/docs"
       }
     }
   }

   复制

7. 7OpenCode 配置 MCP

   写入全局 ~/.config/opencode/opencode.json 或项目级 opencode.json，type 设为 remote；使用时在提示词加 use pg-aiguide。

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "pg-aiguide": {
         "type": "remote",
         "url": "https://mcp.tigerdata.com/docs"
       }
     }
   }

   复制

关键配置

如何确认成功

在 AI 工具的提示词中加入 use pg-aiguide，提问 PostgreSQL 建表问题，若返回手册检索或技能内容即接入成功。

常见问题

注意事项

• 各工具配置文件路径不同：Cursor 为 .cursor/mcp.json，Windsurf 为 ~/.codeium/windsurf/mcp_config.json，OpenCode 为 ~/.config/opencode/opencode.json。
• Claude Code 插件方式同时使用仓库 skills 目录中的技能和托管的 MCP 端点，与单纯的 MCP 配置不同。
• MCP 端点为公共托管服务，使用过程依赖网络连通性。