FRENES

Databases · MCP server

Pg aiguide: MCP server, setup and security

Pg aiguide is an open-source MCP server that lets an AI agent consult PostgreSQL documentation, best practices and tools from its ecosystem. Its repository has 1,873 stars and its last commit is from October 22, 2026 and it is licensed under Apache-2.0.

Score
78/100
Adoption (stars) 33/40
Maintenance 30/30
Framework (licence, registry, official) 15/30
Actively maintainedNeeds secretsRemote serverTop 10% by stars

What Pg aiguide does

According to its repository: “Comprehensive PostgreSQL documentation and best practices, including ecosystem tools”

An MCP server gives an AI agent extra tools it calls during the conversation: the agent reads their description, decides to use them and gets the result back. Pg aiguide is listed under Databases, a category of 138 servers in the directory, where it ranks #10 by stars.

Topics declared by the repository: ai-agents, ai-coding, claude-marketplace, claude-plugin, claude-skills, docs.

Installing and connecting Pg aiguide

Distribution modes declared in the official MCP registry:

  • npm package (Node.js, usually started with npx)
  • Docker (OCI) image
  • remote server (streamable-http): you connect to it by URL, with nothing to install locally

Like any MCP server, you declare it in your client's configuration (Claude Desktop, Claude Code, Cursor, VS Code, Codex…): a name, the command that starts it or its URL, and any environment variables. The client then starts it and lists its tools. Project language: Python.

The registry lists 14 secret variables to provide (API key, access token). Keep them in the client's environment variables, never in a shared file or a repository.

Security: what to check

An MCP server runs code with the rights you give it, and the model reads its tool descriptions: a malicious or compromised server can hijack the agent. Read the code, or pick a maintained and widely used server, before connecting it.

Points found for Pg aiguide:

  • Secrets: the server acts with your credentials. Create a dedicated key with minimum rights and an expiry date.

Good practice: grant only the rights needed (least privilege), require human approval for irreversible actions, and run the AI agent security check.

Project activity and maintenance

Created on July 23, 2025, the timescale/pg-aiguide repository has 1,873 stars and 119 forks, with 4 open issues. It has more stars than 95% of the servers in the directory. It received changes this month. Version published in the registry: 0.6.1 (September 4, 2026).

Stars measure attention, not quality: a recent, heavily promoted project can collect them fast, while a useful but niche server will have few.

DbxDbx : 27.7K27.7KMCP Toolbox for DatabasesMCP Toolbox for Databases : 16.7K16.7KNhostNhost : 9.4K9.4KJitsuJitsu : 5.1K5.1KPostgres MCP (crystaldba)Postgres MCP (crystaldba) : 3.4K3.4KLINQ to DBLINQ to DB : 3.3K3.3KSupabaseSupabase : 3K3KMindwtrMindwtr : 2.3K2.3KPg aiguidePg aiguide : 1.9K1.9K
GitHub stars of the most followed servers in the category (log scale); Pg aiguide in orange. Checked October 25, 2026.

Verdict

Pg aiguide is one of the most solid servers in its category: followed, maintained and well framed.

Strengths

  • Active project: recent commit
  • Widely followed: 1.9K stars
  • Listed in the official MCP registry
  • Usable remotely, without installation
  • Permissive licence (Apache-2.0)

Limitations

  • Requires an API key or token

Avoid if…

  • You do not want to give credentials to an agent

Frequently asked questions

How do I install Pg aiguide?

Pg aiguide is distributed as npm package (Node.js, usually started with npx), Docker (OCI) image, and a remote server. Add it to your client's MCP configuration (Claude Desktop, Cursor, VS Code…) following the README of timescale/pg-aiguide.

Is Pg aiguide free?

The code is published under the Apache-2.0 licence and can be used free of charge. It needs an API key: the service it connects to may be paid.

Is Pg aiguide safe?

Points to watch: secrets. Give it minimum rights and approve sensitive actions.

Is it an official server?

Nothing says so: it is a project published by timescale on GitHub. Check who maintains it before giving it access.

What are the alternatives to Pg aiguide?

In the same category: Nhost, ArcadeDB MCP Server, Jitsu, and Supabase. Nhost and ArcadeDB MCP Server score higher on our grid.

Related articles

Neutrality. No affiliate links. No vendor pays to be reviewed, rated or ranked. Reviews are directed by François Chollet, neutral and factual, and every data point is dated and sourced. How we score