de en es ja ko ru zh

pg-context

Name: pg-context
Author: mewsyy

by mewsyy

Overview Schema Related Servers Score Discussions

TypeScript

Remote

pg-context

Servidor del Model Context Protocol (MCP) que proporciona a los asistentes de codificación con IA un contexto profundo de PostgreSQL: esquemas en vivo como DDL, salud de los índices, asociaciones de claves foráneas, planes de ejecución de consultas y estadísticas de rendimiento.

pg-context se conecta directamente a tu base de datos PostgreSQL en modo de solo lectura y expone herramientas y recursos para asistentes de IA como Cursor, Claude Code, Cline y Antigravity.

¿Por qué pg-context?

Las herramientas SQL genéricas suelen ejecutar consultas arbitrarias sin proporcionar al asistente de IA un contexto estructural. Esto hace que los modelos adivinen nombres de columnas, alucinen relaciones y generen joins inválidos.

pg-context resuelve este problema al proporcionar:

Contexto de esquema sin conjeturas: Exporta estructuras reales de tablas formateadas como sentencias DDL CREATE TABLE de PostgreSQL con comentarios de claves foráneas y definiciones de índices.
Seguridad de solo lectura: Establece automáticamente default_transaction_read_only = ON en cada conexión de cliente y rechaza sentencias SQL de mutación (como DROP, DELETE, UPDATE, INSERT, TRUNCATE, ALTER).
Información de optimización: Detecta claves foráneas sin índice, altas proporciones de escaneo secuencial, índices sin usar y consultas lentas desde pg_stat_statements.
Conocimiento de extensiones: Identifica las extensiones PostGIS, TimescaleDB y pgvector.

Inicio Rápido

Puedes ejecutar pg-context directamente mediante npx sin instalación manual:

npx -y pg-context-mcp

O instálalo globalmente:

npm install -g pg-context-mcp
pg-context-mcp

Configuración

pg-context lee los parámetros de conexión de las variables de entorno o de las cadenas de conexión estándar de PostgreSQL:

Variable	Descripción	Por defecto
`DATABASE_URL`	URI de conexión estándar de PostgreSQL	`undefined`
`PGHOST`	Host de la base de datos	`localhost`
`PGPORT`	Puerto de la base de datos	`5432`
`PGDATABASE`	Nombre de la base de datos	`postgres`
`PGUSER`	Usuario de la base de datos	`postgres`
`PGPASSWORD`	Contraseña de la base de datos	`""`
`PGSSL`	Habilitar conexión SSL (`true`/`false`)	`false`
`PG_SCHEMAS`	Lista separada por comas de esquemas objetivo	`public`
`PG_MAX_CONNECTIONS`	Tamaño del grupo de conexiones	`5`
`PG_CACHE_TTL`	TTL de caché de esquema en segundos	`60`
`PG_QUERY_LIMIT`	Límite de filas predeterminado para `read_query`	`100`
`PG_QUERY_LIMIT_MAX`	Límite máximo absoluto para `read_query`	`1000`

Integración con Clientes

1. Claude Desktop & Antigravity

Añade la siguiente entrada a tu claude_desktop_config.json o a la configuración MCP de Antigravity:

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

2. Cursor

Añade lo siguiente a tu configuración MCP de Cursor (.cursor/mcp.json o Configuración de Cursor > Funciones > MCP):

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

3. Cline (Extensión de VS Code)

Añade esta configuración en cline_mcp_settings.json:

{
  "mcpServers": {
    "pg-context": {
      "command": "npx",
      "args": ["-y", "pg-context-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/my_database"
      }
    }
  }
}

Referencia de Herramientas

pg-context expone 12 herramientas MCP:

Herramienta	Parámetros	Descripción
`list_schemas`	ninguno	Lista todos los esquemas no del sistema de la base de datos.
`list_tables`	`schema` (por defecto: `"public"`)	Lista las tablas y vistas con tamaños, recuentos estimados de filas y comentarios.
`describe_table`	`table`, `schema` (por defecto: `"public"`)	Devuelve el DDL estructural completo de una tabla, incluyendo columnas, tipos, valores por defecto, NOT NULL, claves foráneas e índices.
`list_foreign_keys`	`schema` (por defecto: `"public"`), `table` (opcional)	Muestra las relaciones de claves foráneas como asociaciones legibles `source -> target`.
`list_indexes`	`schema` (por defecto: `"public"`), `table` (opcional)	Muestra los índices, definiciones, tamaños y recuentos de escaneo.
`suggest_indexes`	`schema` (por defecto: `"public"`), `table` (opcional)	Identifica claves foráneas sin índice, advertencias de escaneo secuencial e índices sin usar.
`read_query`	`sql`, `limit` (opcional)	Ejecuta consultas de solo lectura con límites aplicados y devuelve tablas Markdown.
`explain_query`	`sql`, `analyze` (booleano, por defecto: `"false"`)	Devuelve los planes de ejecución de consultas de PostgreSQL `EXPLAIN` o `EXPLAIN ANALYZE`.
`get_database_info`	ninguno	Devuelve la versión de PostgreSQL, el tamaño total de la base de datos, el número de conexiones y la configuración del búfer.
`get_table_stats`	`schema` (por defecto: `"public"`), `table` (opcional)	Devuelve los escaneos secuenciales frente a los de índice, filas vivas, filas muertas y fechas de mantenimiento.
`get_slow_queries`	`limit` (por defecto: `15`)	Obtiene las consultas más lentas registradas por `pg_stat_statements`.
`list_extensions`	ninguno	Lista las extensiones de PostgreSQL instaladas y marca capacidades para PostGIS, TimescaleDB y pgvector.

Referencia de Recursos

pg-context expone 3 recursos MCP:

URI del recurso	Tipo MIME	Descripción
`pg://schema/full`	`text/x-sql`	Volcado DDL completo de todas las tablas de los esquemas configurados.
`pg://schema/{tableName}`	`text/x-sql`	Definición DDL de una tabla individual.
`pg://stats/overview`	`text/markdown`	Resumen de salud de la base de datos: tamaños de almacenamiento, filas muertas y alertas de optimización.

Desarrollo

# Clone the repository
git clone https://github.com/mewsyy/pg-context.git
cd pg-context

# Install dependencies
npm install

# Run test suite
npm test

# Build TypeScript
npm run build

# Start local server
npm start

Licencia

MIT (c) Semen

This server cannot be installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

nlqdb — analytical memory for AI agents
Analytical memory for AI agents: a real Postgres queried in plain English over MCP. One command.
mcp
MCP server for managing Prisma Postgres.
Supabase
MCP server for interacting with the Supabase platform

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mewsyy/pg-context'

If you have feedback or need assistance with the MCP directory API, please join our Discord server