# 🐘 Postgres-Explorer MCP Server

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

```env
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:

```bash
docker build -t mi-mcp-postgres .
```

Luego agrega esto a tu `.mcp.json`:

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

o a tu `opencode.json`:
```json
{
  "mcp": {
    "postgres-explorer": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "--network",
        "host",
        "--env-file",
        "/ruta/absoluta/hacia/tu/proyecto/.env",
        "mi-mcp-postgres"
      ]
    }
  }
}
``` 

### ⚡ Opción 2 — Python directo

```json
{
  "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**.