# PostgreSQL MCP Server

Servidor MCP (Model Context Protocol) para acceso de **solo lectura** a bases de datos PostgreSQL.

## Características

Este servidor MCP proporciona herramientas para:

- 📋 **Listar tablas** disponibles en la base de datos
- 🔍 **Ver estructura** completa de tablas (columnas, tipos, constraints, índices)
- 📊 **Obtener estadísticas** de tablas (filas, tamaño, última actualización)
- 🔎 **Ejecutar queries SELECT** de solo lectura (protegido contra operaciones de escritura)

## Instalación

```bash
# Instalar dependencias
npm install

# Compilar el proyecto
npm run build
```

## Configuración en Claude Desktop

Agrega la configuración del servidor MCP en tu archivo de configuración de Claude Desktop:

### macOS

Edita: `~/Library/Application Support/Claude/claude_desktop_config.json`

### Windows

Edita: `%APPDATA%\Claude\claude_desktop_config.json`

Configuración:

```json
{
  "mcpServers": {
    "postgres-mcp": {
      "command": "node",
      "args": [
        "/ruta/absoluta/a/postgres-mcp/build/index.js"
      ],
      "env": {
        "PGHOST": "localhost",
        "PGPORT": "5432",
        "PGDATABASE": "tu_base_de_datos",
        "PGUSER": "tu_usuario",
        "PGPASSWORD": "tu_password"
      }
    }
  }
}
```

**Importante**: Reemplaza `/ruta/absoluta/a/postgres-mcp` con la ruta real donde clonaste el proyecto.

## Herramientas Disponibles

### 1. `list_tables`

Lista todas las tablas en un schema.

**Parámetros:**

- `schema` (opcional): Nombre del schema (por defecto: 'public')

**Ejemplo de uso:**

```bash
Lista todas las tablas de la base de datos
```

### 2. `describe_table`

Muestra la estructura completa de una tabla.

**Parámetros:**

- `table_name` (requerido): Nombre de la tabla
- `schema` (opcional): Nombre del schema (por defecto: 'public')

**Ejemplo de uso:**

```bash
Muéstrame la estructura de la tabla users
```

### 3. `query`

Ejecuta una consulta SELECT de solo lectura.

**Parámetros:**

- `sql` (requerido): Consulta SQL SELECT
- `limit` (opcional): Límite de filas a retornar (por defecto: 100)

**Ejemplo de uso:**

```bash
Ejecuta esta query: SELECT * FROM users WHERE active = true
```

### 4. `table_stats`

Obtiene estadísticas de una tabla.

**Parámetros:**

- `table_name` (requerido): Nombre de la tabla
- `schema` (opcional): Nombre del schema (por defecto: 'public')

**Ejemplo de uso:**

```bash
Muéstrame las estadísticas de la tabla products
```

## Seguridad

🔒 **Este servidor está diseñado para ser de solo lectura**:

- Solo permite consultas `SELECT`
- Bloquea operaciones: `INSERT`, `UPDATE`, `DELETE`, `DROP`, `CREATE`, `ALTER`, `TRUNCATE`, etc.
- Aplica límites automáticos a las consultas que no especifican `LIMIT`

## Desarrollo

```bash
# Compilar en modo watch
npm run watch

# Ejecutar en desarrollo
npm start
```

## Troubleshooting

### Error de conexión a PostgreSQL

- Verifica que PostgreSQL esté corriendo
- Confirma las credenciales en el archivo `.env`
- Verifica que el usuario tenga permisos de lectura en la base de datos

### El servidor no aparece en Claude Desktop

- Asegúrate de haber reiniciado Claude Desktop después de editar la configuración
- Verifica que la ruta al archivo `build/index.js` sea absoluta y correcta
- Revisa los logs de Claude Desktop para ver errores

### "Query no permitida"

- Solo se permiten consultas `SELECT`
- Asegúrate de no usar operaciones de escritura en tus queries