convez.ai
MCP ServerIntegração & APIsIntermediário
DeamonDev888

MCP Server PostgreSQL

DeamonDev888/PostgreSQL-MCP-Serveur

Servidor MCP com RAG semântico para PostgreSQL e memory management avançado

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP especializado em interação com PostgreSQL que integra RAG (Retrieval-Augmented Generation) de grau institucional. Oferece sistema de memória semântica de alta performance com suporte a pgvector e embeddings, permitindo agents navegarem naturalmente pela base de dados sem escrever SQL manualmente.

Instalação

$npx convez-ai DeamonDev888/PostgreSQL-MCP-Serveur

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Conectar Claude e agents com bases PostgreSQL para consultas semânticas
  • Implementar memória isolada por agent com acesso a knowledge base compartilhada
  • Construir pipelines RAG de grau institucional com embeddings SOTA
  • Automatizar interações com banco de dados através de linguagem natural

Veredito

MCP server robusto e bem documentado para PostgreSQL com diferencial RAG semântico. Produção-ready mas demanda infraestrutura (pgvector, embeddings API) e conhecimento de configuração MCP para máximo aproveitamento.

README

A tradução para o português deste README ainda está na fila.


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 :

# 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)

{
  "mcpServers": {
    "postgresql": {
      "command": "overmind-postgres-mcp"
    }
  }
}

2. Variables d'Environnement (.env)

Le serveur charge automatiquement les fichiers .env pour sécuriser vos accès :

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), vous pouvez utiliser les services directement.

Installation

pnpm add overmind-postgres-mcp

1. Embeddings (Intelligence Sémantique)

Générez des vecteurs haute qualité compatibles avec vos tables PostgreSQL.

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.

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.

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)

{
  "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)

use_tool("manage_vectors", {
  action: "create",
  table: "knowledge_base",
  dimensions: 4096,
});

2. Insertion avec Auto-Embedding

use_tool("insert", {
  table: "knowledge_base",
  data: { content: "Guide d'installation..." },
  generateEmbedding: true,
});

3. Recherche Hybride (RAG)

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

Ver o original no GitHub

Bom para

Relacionados