Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

DBeast PostgreSQL MCP

de snss10versión 2.0.2i★ 9iSe ejecuta en tu computadora
Nombre en el registroio.github.snss10/dbeast

Cómo instalar

What it does

PostgreSQL MCP server for schema, query, health, security, and performance analysis.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs DATABASE_URL, DB_PASSWORD, AWS_SECRET_NAME
  • Category Bases de datos y conjuntos de datos

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de DBeast PostgreSQL MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "dbeast": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "DATABASE_URL",
            "-e",
            "DB_PASSWORD",
            "-e",
            "AWS_SECRET_NAME",
            "ghcr.io/snss10/dbeast:2.0.2"
          ],
          "env": {
            "DATABASE_URL": "your-value",
            "DB_PASSWORD": "your-value",
            "AWS_SECRET_NAME": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa DBeast PostgreSQL MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando DBeast PostgreSQL MCP o muestra una herramienta de DBeast PostgreSQL MCP en la respuesta, ya está conectado

5 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DB_HOST PostgreSQL host when DATABASE_URL is not used.
  • DB_PORT PostgreSQL port when DATABASE_URL is not used.
  • DB_USER PostgreSQL user when DATABASE_URL is not used.
  • DB_NAME PostgreSQL database name when DATABASE_URL is not used.
  • AWS_REGION AWS region for Secrets Manager lookup.

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar DBeast PostgreSQL MCP

DBeast PostgreSQL MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar DBeast PostgreSQL MCP

  • Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
  • Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
  • Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)

B · Otros en Bases de datos y conjuntos de datos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de DBeast PostgreSQL MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add --scope user dbeast --env DATABASE_URL=your-value --env DB_PASSWORD=your-value --env AWS_SECRET_NAME=your-value -- docker run -i --rm -e DATABASE_URL -e DB_PASSWORD -e AWS_SECRET_NAME ghcr.io/snss10/dbeast:2.0.2

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver DBeast PostgreSQL MCP en la lista como conectado

  6. Pruébalo

    Usa DBeast PostgreSQL MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando DBeast PostgreSQL MCP o muestra una herramienta de DBeast PostgreSQL MCP en la respuesta, ya está conectado

5 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DB_HOST PostgreSQL host when DATABASE_URL is not used.
  • DB_PORT PostgreSQL port when DATABASE_URL is not used.
  • DB_USER PostgreSQL user when DATABASE_URL is not used.
  • DB_NAME PostgreSQL database name when DATABASE_URL is not used.
  • AWS_REGION AWS region for Secrets Manager lookup.

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de DBeast PostgreSQL MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de DBeast PostgreSQL MCP, DATABASE_URL, DB_PASSWORD, AWS_SECRET_NAME está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa DBeast PostgreSQL MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando DBeast PostgreSQL MCP o muestra una herramienta de DBeast PostgreSQL MCP en la respuesta, ya está conectado

5 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DB_HOST PostgreSQL host when DATABASE_URL is not used.
  • DB_PORT PostgreSQL port when DATABASE_URL is not used.
  • DB_USER PostgreSQL user when DATABASE_URL is not used.
  • DB_NAME PostgreSQL database name when DATABASE_URL is not used.
  • AWS_REGION AWS region for Secrets Manager lookup.

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de DBeast PostgreSQL MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)

  1. Instala Docker

    Una sola vez; sirve para todos los servidores que necesitan Docker

    Abrir la página de descarga de Docker ↗

  2. Regístrate y crea una clave de DBeast PostgreSQL MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de DBeast PostgreSQL MCP, DATABASE_URL, DB_PASSWORD, AWS_SECRET_NAME está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa DBeast PostgreSQL MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando DBeast PostgreSQL MCP o muestra una herramienta de DBeast PostgreSQL MCP en la respuesta, ya está conectado

5 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DB_HOST PostgreSQL host when DATABASE_URL is not used.
  • DB_PORT PostgreSQL port when DATABASE_URL is not used.
  • DB_USER PostgreSQL user when DATABASE_URL is not used.
  • DB_NAME PostgreSQL database name when DATABASE_URL is not used.
  • AWS_REGION AWS region for Secrets Manager lookup.

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa DBeast PostgreSQL MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user dbeast --env DATABASE_URL=your-value --env DB_PASSWORD=your-value --env AWS_SECRET_NAME=your-value -- docker run -i --rm -e DATABASE_URL -e DB_PASSWORD -e AWS_SECRET_NAME ghcr.io/snss10/dbeast:2.0.2

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "dbeast": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "DB_PASSWORD",
        "-e",
        "AWS_SECRET_NAME",
        "ghcr.io/snss10/dbeast:2.0.2"
      ],
      "env": {
        "DATABASE_URL": "your-value",
        "DB_PASSWORD": "your-value",
        "AWS_SECRET_NAME": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "dbeast": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "DB_PASSWORD",
        "-e",
        "AWS_SECRET_NAME",
        "ghcr.io/snss10/dbeast:2.0.2"
      ],
      "env": {
        "DATABASE_URL": "your-value",
        "DB_PASSWORD": "your-value",
        "AWS_SECRET_NAME": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "dbeast": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DATABASE_URL",
        "-e",
        "DB_PASSWORD",
        "-e",
        "AWS_SECRET_NAME",
        "ghcr.io/snss10/dbeast:2.0.2"
      ],
      "env": {
        "DATABASE_URL": "your-value",
        "DB_PASSWORD": "your-value",
        "AWS_SECRET_NAME": "your-value"
      }
    }
  }
}

Valores que debes completar

  • DATABASE_URL secreto obligatorio env
    PostgreSQL connection URL, for example postgresql://user:password@host:5432/database.
  • DB_HOST env
    PostgreSQL host when DATABASE_URL is not used.
  • DB_PORT env
    PostgreSQL port when DATABASE_URL is not used.
  • DB_USER env
    PostgreSQL user when DATABASE_URL is not used.
  • DB_PASSWORD secreto obligatorio env
    PostgreSQL password when DATABASE_URL is not used.
  • DB_NAME env
    PostgreSQL database name when DATABASE_URL is not used.
  • AWS_SECRET_NAME secreto obligatorio env
    AWS Secrets Manager secret containing PostgreSQL credentials.
  • AWS_REGION env
    AWS region for Secrets Manager lookup.

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en tu computadora
Última versióni
2.0.2
Publicado en el registroi
11 jun 2026
Último cambio de códigoi
10 ago 2026
Creador
snss10
Paquetes
oci: ghcr.io/snss10/dbeast:2.0.2
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub snss10, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 3 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Bases de datos y conjuntos de datosi

  • Más estrellas que el 92% de los otros 1194 servidores de esta categoría
  • Publicado en el registro más recientemente que el 13% de los otros 1194 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 1194 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro DBeast PostgreSQL MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: DATABASE_URL, DB_PASSWORD, AWS_SECRET_NAME

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 3 meses, y la última versión (2.0.2) llegó al registro hace 5 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Dbx

Query databases from AI agents using connections configured in DBX.

de t8y2Muy usado↓ 9,4 mil/sem★ 30,3 milActualizado hace 6 meses

Se ejecuta en tu computadora

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

de googleapisMuy usado★ 16,9 milActualizado ayer

Se ejecuta en tu computadora

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

de googleapisMuy usado★ 16,9 milActualizado hace 8 meses

Se ejecuta en tu computadora

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

A PostgreSQL MCP server that gives AI assistants expert DBA capabilities.

Quick Start · Demo · Tools · Safety · Configuration · Docs


DBeast connects AI assistants such as Claude, Cursor, Windsurf, and VS Code Copilot to PostgreSQL through the Model Context Protocol. Instead of exposing one broad execute_sql escape hatch, DBeast provides 21 focused tools for schema discovery, safe query execution, impact analysis, performance review, security checks, maintenance reporting, replication monitoring, and data quality inspection.


Demo

Watch Claude use DBeast MCP tools to audit a PostgreSQL database, identify security and maintenance risks, and preview cleanup impact without executing destructive SQL.

Watch the demo on YouTube


How It Works

AI assistant  --MCP stdio-->  DBeast server  --asyncpg-->  PostgreSQL

Claude/Cursor Python local Local, RDS, Windsurf/VS Code subprocess Supabase, Neon

DBeast runs as a local stdio MCP server. Your IDE or desktop assistant starts it as a subprocess and passes database credentials through environment variables. The assistant calls DBeast tools, DBeast queries PostgreSQL, and structured results come back to the assistant. No HTTP service or extra infrastructure is required.


Quick Start

1. Install
git clone https://github.com/snss10/DBeast.git

cd DBeast pip install -e .

For development:

pip install -e ".[dev]"

Optional: copy .env.example to .env and set your database credentials.

2. Verify
dbeast

Or run the source entry point directly:

python src/server.py
3. Configure Your MCP Client

Minimal Cursor or Windsurf config:

{

"mcpServers": { "dbeast": { "type": "stdio", "command": "python", "args": ["/absolute/path/to/DBeast/src/server.py"], "env": { "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb" } } } }

Common config locations:

ClientConfig location
Cursor.mcp.json in project root, or ~/.cursor/.mcp.json globally
VS Code.vscode/settings.json or user settings with key mcp.servers
Claude Desktop on macOS~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop on Windows%APPDATA%\Claude\claude_desktop_config.json
Windsurf.mcp.json

See SETUP.md for full client examples, Docker, RDS, Supabase, Neon, SSH tunnels, AWS Secrets Manager, and troubleshooting.

4. Ask Simple or Complex Questions

Once connected, your assistant can answer quick lookup questions and also run multi-step database investigations.

Simple examples:

Show me the schema for the orders table.

Which queries are slowest right now? Run a security audit on the public schema. Generate a Mermaid ERD for the sales schema.

More complex examples:

Before I archive old sessions, estimate how many rows would be affected, identify related tables, and tell me the rollback risk.

Investigate why the dashboard query is slow, explain the execution plan, and suggest safe indexes. Review the public schema for maintenance issues, security risks, and data quality problems, then summarize the top priorities. Compare table growth, dead tuples, and index health across all schemas and recommend what to vacuum or reindex first.


Tools

DBeast exposes 21 MCP tools across 10 categories.

Connection
ToolDescription
connectConnect to PostgreSQL, check current status, or discover local databases
disconnectClose the current database connection
health_checkVerify connectivity, pool health, PostgreSQL version, and extensions
Schema Discovery
ToolDescription
get_schemaList schemas, tables, columns, indexes, relationships, and optional Mermaid ERDs
dependency_analysisMap object dependencies before renaming, dropping, or changing database objects
Data Access
ToolDescription
execute_queryRun read-only SELECT queries with automatic row-limit injection
Query Analysis
ToolDescription
analyze_queryParse and inspect query structure, warnings, and optimization hints
query_optimizerRecommend indexes and rewrites for a given query
analyze_impactPreview write-query impact, risk level, affected rows, and rollback context without executing
Database Health
ToolDescription
database_healthReview cache hit rates, connections, transaction age, table health, and overall health signals
query_performanceReport slow or expensive queries from PostgreSQL statistics
Security
ToolDescription
security_auditInspect roles, privileges, superuser accounts, and public schema exposure
sensitive_data_scanDetect likely PII or secrets by column names and schema patterns
Maintenance
ToolDescription
maintenance_analysisReview vacuum status, dead tuples, analyze timestamps, and index health
partition_analysisInspect partition health, row distribution, and missing partition risks
Data Quality
ToolDescription
data_quality_reportAnalyze null rates, cardinality, value distributions, and outliers
duplicate_detectionFind duplicate rows across selected key columns
Server Config
ToolDescription
configuration_reviewReview PostgreSQL configuration and tuning opportunities
replication_statusInspect replication lag, WAL sender/receiver state, and replication slots
Audit
ToolDescription
get_audit_logsRetrieve logged MCP tool calls for a given date
list_audit_filesList available audit log files

Recommended Workflow

Start by discovering schemas:

get_schema()

get_schema(schema='public')

Run safe read queries:

execute_query(query='SELECT * FROM orders ORDER BY created_at DESC')

Preview risky writes:

analyze_impact(query='DELETE FROM sessions WHERE last_active < now() - interval ''30 days''')

Check health and maintenance:

database_health()

maintenance_analysis(schema='public') query_performance()

Most analysis tools accept a schema parameter:

maintenance_analysis(schema='public')  -> analyze one schema

maintenance_analysis(schema='all') -> analyze every schema get_schema(format='mermaid') -> generate an ERD diagram


Supported Databases

ProviderConnection method
Local PostgreSQLDATABASE_URL or individual DB_* variables
Docker PostgreSQLExplicit variables or connect(discover=true)
AWS RDS / AuroraDirect URL, SSH tunnel, or AWS Secrets Manager
SupabasePooler connection string from Dashboard settings
NeonConnection string from Console connection details
Railway / Render / Fly.ioProvider connection string
Any PostgreSQL hostStandard PostgreSQL URL

Configuration

Choose one connection method.

# Full URL

DATABASE_URL=postgresql://user:pass@host:5432/db

Or individual variables

DB_HOST=localhost DB_PORT=5432 DB_USER=postgres DB_PASSWORD=secret DB_NAME=mydb DB_SSLMODE=prefer

Or AWS Secrets Manager

AWS_SECRET_NAME=my-rds-secret AWS_REGION=us-west-2

You can also connect at runtime:

connect(url='postgresql://user:pass@host:5432/db')

connect(host='localhost', user='postgres', password='secret', database='mydb') connect(aws_secret_name='my-secret', aws_region='us-west-2')

Key settings:

VariableDefaultDescription
DBEAST_DEFAULT_ROW_LIMIT100Max rows returned by execute_query
DBEAST_QUERY_TIMEOUT300Query execution timeout in seconds
DBEAST_COMMAND_TIMEOUT300SQL command timeout in seconds
DBEAST_SSL_VERIFYtrueSet false for SSH tunnels where certificates do not match localhost
DBEAST_SCHEMA_CACHE_TTL60Schema cache TTL in seconds, 0 disables caching
DBEAST_AUDIT_ENABLEDtrueLog MCP tool calls
DBEAST_AUDIT_DIRlogs/mcp_auditAudit log directory

See SETUP.md for the complete configuration reference.


Safety Model

Query typeWhat DBeast does
SELECTExecutes with automatic row limits
INSERT / UPDATE / DELETENever executed; returns an impact preview
DROP / TRUNCATENever executed; reports affected objects and risk

Formatted and JSON responses use a consistent wrapper:

{

"success": true, "data": { "...": "..." }, "meta": { "connected": true, "source": "tool" } }


Audit Logging

DBeast logs MCP tool calls for accountability and debugging.

DBEAST_AUDIT_ENABLED=true

DBEAST_AUDIT_DIR=logs/mcp_audit

Audit files are stored as daily markdown files and include timestamps, tool names, durations, masked parameters, truncated responses, and errors.


Development

pip install -e ".[dev]"

pre-commit install pytest tests/ -v ruff check src/ tests/ ruff format src/ tests/

Start the optional local PostgreSQL test database:

docker compose up -d postgres

Legacy Compose:

docker-compose up -d postgres

Documentation


License

MIT