Postgresql MCP Serveur

______________________________________________________________________

用于与PostgreSQL交互的强大MCP服务器，以及用于语义智能的TypeScript库。

• 🧠 高性能内存（4096D） ：通过PostgreSQL+pgvector集成RAG系统，支持SOTA嵌入（QWEN 8B）。
• 🛡️ 隔离记忆 ：每个代理都可以拥有自己的孤立记忆，同时可以访问全球知识库。
• 🤖 导航自动命名 ：代理通过默认嵌入模型与数据库自然交互，无需编写复杂的SQL查询（特殊情况除外）。

📦 安装

通过npm或pnpm安装PostgreSQL MCP服务器：

# Via npm
npm install -g overmind-postgres-mcp

# Via pnpm (recommandé)
pnpm add -g overmind-postgres-mcp

🚀 快速启动（使用MCP）

使用此服务器的最简单方法是将其配置为您最喜欢的客户端（claude@code、antigravity等）中的MCP服务器。

1.配置（.mcp.json）

{
  "mcpServers": {
    "postgresql": {
      "command": "npx",
      "args": ["-y", "overmind-postgres-mcp"]
    }
  }
}

2.环境变量（.env）

服务器自动加载文件 .env 为了保护您的访问：

POSTGRES_URL=postgresql://user:pass@localhost:5432/db
OPEN_ROUTER_API_KEY=sk-or-v1-...

______________________________________________________________________

📚 高级用法（TypeScript库）

如果您正在开发自己的编排器（如项目 过度关注mcp），您可以直接使用服务。

安装

pnpm add overmind-postgres-mcp

1.嵌入（语义智能）

生成与PostgreSQL表兼容的高质量向量。

import { embedText } from "overmind-postgres-mcp/services/embeddings";

const { embedding, model } = await embedText("Votre texte ici");

2.混合研究

利用本地混合搜索的力量。

import { IntelligentSearchService } from "overmind-postgres-mcp/services/search";

const searchService = new IntelligentSearchService();
const results = await searchService.hybridSearch({
  query: "Comment configurer le serveur ?",
  table: "documents",
});

零配置（.env）

建议使用文件 .env 避免在主机配置文件（如Claude Desktop）中暴露您的秘密。服务器自动加载文件 .env 在其根目录或执行文件夹中。

POSTGRES_HOST=localhost
POSTGRES_USER=postgres
POSTGRES_PASSWORD=votre_mot_de_passe
POSTGRES_DATABASE=votre_db
OPEN_ROUTER_API_KEY=sk-or-v1-...

MCP服务器配置（.MCP.json）

{
  "mcpServers": {
    "postgresql": {
      "command": "node",
      "args": ["/chemin/vers/postgresql-mcp-server/dist/index.js"]
    }
  }
}

______________________________________________________________________

💡 使用示例（代理）

1.为Qwen准备一张桌子（4096尺寸）

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

2.自动嵌入插入

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

3.混合研究（RAG）

use_tool("search", {
  query: "Comment installer ?",
  table: "knowledge_base",
  mode: "hybrid",
});

______________________________________________________________________

🗄️ 迁移

乐档案 migrations/ 包含配置扩展所需的SQL脚本 pgvector 并优化您的表以进行高性能搜索。

______________________________________________________________________

📄 许可证

麻省理工学院