Postgres Explorer

Servidor MCP que permite a Claude Code explorar y consultar una base de datos PostgreSQL de forma segura (solo lectura).

✅ Requisitos

• 🐍 Python >= 3.12
• 🗄️ PostgreSQL accesible
• 🐳 Docker (opcional)

🔐 Variables de entorno

DB_HOST=localhost
DB_NAME=name_example
DB_USER=user_example
DB_PASSWORD=password_example
DB_PORT=5432

⚙️ Configuración para Claude Code

Agrega esto a tu .mcp.json en la raíz del proyecto:

🐳 Opción 1 — Docker (recomendado)

Primero construye la imagen desde la raíz del proyecto:

docker build -t mi-mcp-postgres .

Luego agrega esto a tu .mcp.json:

{
  "mcpServers": {
    "postgres-explorer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network",
        "host",
        "--env-file",
        "/ruta/absoluta/hacia/tu/proyecto/.env",
        "mi-mcp-postgres"
      ]
    }
  }
}

⚡ Opción 2 — Python directo

{
  "mcpServers": {
    "postgres-explorer": {
      "command": "uv",
      "args": ["run", "python", "main.py"]
    }
  }
}

🛠️ Herramientas disponibles

Herramienta	Descripción
get_schema	📋 Lista todas las tablas y sus columnas del esquema public
execute_query	🔍 Ejecuta una consulta SELECT y devuelve resultados

🔒 Seguridad: solo permite SELECT. Conexiones en modo read-only.