# postgres-mcp-server

Servidor MCP (Model Context Protocol) para consultar bases **PostgreSQL en modo solo
lectura**. Expone una tool que ejecuta consultas `SELECT` y las devuelve al agente.

> **Origen y por qué existe este repo.** Es una copia del componente original
> [`@modelcontextprotocol/server-postgres`](https://www.npmjs.com/package/@modelcontextprotocol/server-postgres)
> de Anthropic, publicado bajo licencia **MIT**. Ese paquete fue **deprecado** por sus
> autores ("no longer supported"). Como lo usamos en la POC, lo conservamos acá para
> **no depender de que siga publicado en npm** y tener el código bajo nuestro control.
> Se mantiene la licencia y la atribución originales (ver [LICENSE](./LICENSE)).

## Requisitos

- Node.js >= 18
- Una base PostgreSQL accesible

## Instalación

```bash
git clone https://github.com/negrip/postgres-mcp-server.git
cd postgres-mcp-server
npm install
```

`npm install` baja las dependencias (`pg` y `@modelcontextprotocol/sdk`), que **no**
están deprecadas y siguen mantenidas.

## Uso

Se ejecuta con `node`, pasando el connection string de PostgreSQL como argumento:

```bash
node dist/index.js "postgresql://usuario:password@host:5432/basededatos"
```

### Integración con el proxy GEAI (GLOB.AI OS)

En el archivo de configuración de MCP servers del proxy:

```json
{
  "mcpServers": {
    "PostgresReportes": {
      "command": "node",
      "args": [
        "C:/ruta/a/postgres-mcp-server/dist/index.js",
        "postgresql://usuario:password@localhost:5432/basededatos"
      ]
    }
  }
}
```

La tool queda registrada como `PostgresReportes__query` (nombre del server + `__query`).

## Nota de mantenimiento

Este componente ya no recibe actualizaciones de su autor original. Funciona para uso de
solo lectura acotado. Si a futuro se necesita un conector PostgreSQL MCP con
mantenimiento activo, evaluar alternativas mantenidas por la comunidad o vendors.

## Licencia

MIT — ver [LICENSE](./LICENSE). Se conserva la licencia y el copyright del proyecto
original de Anthropic, PBC.