gem-hunter
Language: Python
MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
AI-optimized PostgreSQL expertise for coding assistants
pg-aiguide helps AI coding tools write dramatically better PostgreSQL code. It provides:
Use it as:
npx skills — works with Claude Code, Cursor, Codex, Gemini CLI, and 40+ other agentsAI coding tools often generate Postgres code that is:
pg-aiguide fixes that by giving AI agents deep, versioned PostgreSQL knowledge and proven patterns.
how-to-train-your-agent.mp4 Video TranscriptPrompt given to Claude Code:
Please describe the schema you would create for an e-commerce website two times, first with the tiger mcp server disabled, then with the tiger mcp server enabled. For each time, write the schema to its own file in the current working directory. Then compare the two files and let me know which approach generated the better schema, using both qualitative and quantitative reasons. For this example, only use standard Postgres.
Result (summarized):
GENERATED ALWAYS AS IDENTITY, NULLS NOT DISTINCT)Conclusion: pg-aiguide produces more robust, performant, maintainable schemas.
Install curated PostgreSQL best-practice skills for your AI coding agent:
npx skills add timescale/pg-aiguide --skill postgres
Or install the schema exploration skill to investigate an existing PostgreSQL database:
npx skills add timescale/pg-aiguide --skill schema-exploration
Or pick individual skills interactively:
npx skills add timescale/pg-aiguide
Works with Claude Code, Cursor, Codex, Gemini CLI, VS Code, and 40+ other agents.
For even deeper PostgreSQL knowledge, also add the MCP server to give your agent semantic search over the official PostgreSQL, TimescaleDB, and PostGIS manuals.
For semantic search over PostgreSQL, TimescaleDB, and PostGIS documentation, add the public MCP server:
https://mcp.tigerdata.com/docs
Manual MCP configuration using JSON{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}Or it can be used as a Claude Code Plugin:
claude plugin marketplace add timescale/pg-aiguide claude plugin install pg@aiguide
This repo serves as a claude code marketplace plugin. To install, run:
claude plugin marketplace add timescale/pg-aiguide claude plugin install pg@aiguide
This plugin uses the skills available in the skills directory as well as our
publicly available MCP server endpoint hosted by TigerData for searching PostgreSQL documentation.
Run the following to add the MCP server to codex:
codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguideOne-click install:
Or add the following to .cursor/mcp.json
{
"mcpServers": {
"pg-aiguide": {
"url": "https://mcp.tigerdata.com/docs"
}
}
}Run the following to add the MCP server to Gemini CLI:
gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t httpAdd the following to your global OpenCode config file (~/.config/opencode/opencode.json), or to a
project level opencode.json. See the OpenCode config docs for
more about file locations, and the MCP server docs for more
about the mcp options.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"pg-aiguide": {
"type": "remote",
"url": "https://mcp.tigerdata.com/docs"
}
}
}Add use pg-aiguide to your prompts to use the pg-aiguide tools.
Click the button to install:
Click the button to install:
Alternatively, run the following to add the MCP server to VS Code:
code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'Click the button to install:
Alternatively, run the following to add the MCP server to VS Code Insiders:
code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'Add the following to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pg-aiguide": {
"serverUrl": "https://mcp.tigerdata.com/docs"
}
}
}Once installed, pg-aiguide can answer Postgres questions or design schemas.
Simple schema example prompt
Create a Postgres table schema for storing usernames and unique email addresses.
Complex schema example prompt
You are a senior software engineer. You are given a task to generate a Postgres schema for an IoT device company. The devices collect environmental data on a factory floor. The data includes temperature, humidity, pressure, as the main data points as well as other measurements that vary from device to device. Each device has a unique id and a human-readable name. We want to record the time the data was collected as well. Analysis for recent data includes finding outliers and anomalies based on measurements, as well as analyzing the data of particular devices for ad-hoc analysis. Historical data analysis includes analyzing the history of data for one device or getting statistics for all devices over long periods of time.
search_docs
Unified search tool supporting semantic (vector similarity) and keyword (BM25) search across multiple documentation sources:
postgres - Official PostgreSQL manual, scoped by versiontiger - Tiger Data's documentation (TimescaleDB and ecosystem)postgis - PostGIS spatial extension documentationview_skill
Exposes curated, opinionated PostgreSQL best-practice skills used automatically by AI coding assistants.
These skills provide guidance on:
Supported today:
Coming soon:
We welcome contributions for additional extensions and tools.
See DEVELOPMENT.md for:
We welcome:
Apache 2.0