PostgreSQL MCP服务器

高性能的PostgreSQL交互服务器,结合TypeScript库实现语义智能功能。

  • by DeamonDev888
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DeamonDev888/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": "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 并优化您的表以进行高性能搜索。


📄 许可证

麻省理工学院