Claude DalBen-Postgre MCP Server

Questo server MCP permette a Claude di connettersi al tuo database PostgreSQL tramite il Model Context Protocol.

🚀 Installazione

1. Prerequisiti

Node.js (versione 18 o superiore)
Database PostgreSQL accessibile

2. Clona il repository

git clone https://github.com/MarcoSalmaso/DalBen-PostgreSQL-MCP.git
cd DalBen-PostgreSQL-MCP

3. Installa le dipendenze

npm install

4. Configura il database

Copia il file di esempio:

cp .env.example .env

Modifica il file .env con i tuoi parametri:

DB_HOST=your_host_here
DB_PORT=5432
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password
DB_SSL=false

5. Testa la connessione

npm run test

6. Configura Claude Desktop

Aggiungi questa configurazione al file di Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "DalBen-Postgre": {
      "command": "node",
      "args": ["/percorso/completo/al/progetto/server.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

7. Riavvia Claude Desktop

🛠️ Funzionalità

Lista tabelle: Visualizza tutte le tabelle del database
Descrivi struttura: Ottieni dettagli di colonne, tipi di dati, vincoli
Esegui query: Esegui query SQL personalizzate
Visualizza dati: Ottieni campioni di dati dalle tabelle

📋 Comandi disponibili

Una volta configurato, potrai usare Claude per:

"Mostrami tutte le tabelle nel database"
"Descrivi la struttura della tabella 'users'"
"Esegui questa query: SELECT * FROM orders WHERE date > '2024-01-01'"
"Mostrami i primi 20 record della tabella 'products'"

🔧 Script di utilità

npm start - Avvia il server MCP
npm test - Testa la connessione al database

🔐 Sicurezza

Le credenziali del database sono gestite tramite variabili d'ambiente
Il file .env è ignorato da git per evitare di esporre credenziali
Usa sempre connessioni SSL in produzione

🤝 Contribuire

Fork del repository
Crea un branch per la tua feature
Commit delle modifiche
Push del branch
Apri una Pull Request

📄 Licenza

MIT License