---
Un serveur MCP performant pour interagir avec PostgreSQL, doublé d'une bibliothèque TypeScript pour l'intelligence sémantique.
- **🧠 Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + pgvector supportant les embeddings SOTA (Qwen 8B).
- **🛡️ Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle de connaissances global.
- **🤖 Navigation Autonome** : L'agent interagit naturellement avec la base de données via le modèle d'embedding par défaut, sans avoir besoin d'écrire des requêtes SQL complexes (sauf cas spécifique).
## 📦 Installation
Installez le serveur MCP PostgreSQL via npm ou pnpm :
```bash
# Via npm
npm install -g overmind-postgres-mcp
# Via pnpm (recommandé)
pnpm add -g overmind-postgres-mcp
```
## 🚀 Démarrage Rapide (Usage MCP)
La façon la plus simple d'utiliser ce serveur est de le configurer comme un serveur MCP dans votre client préféré (Claude_code, Antigravity, etc.).
### 1. Configuration (.mcp.json)
```json
{
"mcpServers": {
"postgresql": {
"command": "overmind-postgres-mcp"
}
}
}
```
### 2. Variables d'Environnement (.env)
Le serveur charge automatiquement les fichiers `.env` pour sécuriser vos accès :
```env
POSTGRES_URL=postgresql://user:pass@localhost:5432/db
OPEN_ROUTER_API_KEY=sk-or-v1-...
```
---
## 📚 Usage Avancé (Bibliothèque TypeScript)
Si vous développez votre propre orchestrateur (comme le projet **[overmind-mcp](https://www.npmjs.com/package/overmind-mcp)**), vous pouvez utiliser les services directement.
### Installation
```bash
pnpm add overmind-postgres-mcp
```
### 1. Embeddings (Intelligence Sémantique)
Générez des vecteurs haute qualité compatibles avec vos tables PostgreSQL.
```typescript
import { embedText } from "overmind-postgres-mcp/services/embeddings";
const { embedding, model } = await embedText("Votre texte ici");
```
### 2. Recherche Hybride
Exploitez la puissance de la recherche hybride native.
```typescript
import { IntelligentSearchService } from "overmind-postgres-mcp/services/search";
const searchService = new IntelligentSearchService();
const results = await searchService.hybridSearch({
query: "Comment configurer le serveur ?",
table: "documents",
});
```
### Zero-Config (.env)
Il est recommandé d'utiliser un fichier `.env` pour éviter d'exposer vos secrets dans les fichiers de configuration des hôtes (ex: Claude Desktop). Le serveur charge automatiquement les fichiers `.env` à sa racine ou dans le dossier d'exécution.
```env
POSTGRES_HOST=localhost
POSTGRES_USER=postgres
POSTGRES_PASSWORD=votre_mot_de_passe
POSTGRES_DATABASE=votre_db
OPEN_ROUTER_API_KEY=sk-or-v1-...
```
### Configuration Serveur MCP (.mcp.json)
```json
{
"mcpServers": {
"postgresql": {
"command": "node",
"args": ["/chemin/vers/postgresql-mcp-server/dist/index.js"]
}
}
}
```
---
## 💡 Exemples d'Usage (Agent)
### 1. Préparer une table pour Qwen (4096 dimensions)
```typescript
use_tool("manage_vectors", {
action: "create",
table: "knowledge_base",
dimensions: 4096,
});
```
### 2. Insertion avec Auto-Embedding
```typescript
use_tool("insert", {
table: "knowledge_base",
data: { content: "Guide d'installation..." },
generateEmbedding: true,
});
```
### 3. Recherche Hybride (RAG)
```typescript
use_tool("search", {
query: "Comment installer ?",
table: "knowledge_base",
mode: "hybrid",
});
```
---
## 🗄️ Migrations
Le dossier `migrations/` contient les scripts SQL nécessaires pour configurer l'extension `pgvector` et optimiser vos tables pour les recherches haute performance.
---
## 📄 Licence
MIT