Semantic Postgres MCP

🚀 语义 PostgreSQL MCP 服务器

语义 PostgreSQL MCP 服务器是一个模型上下文协议（MCP）服务器，它能让像 Claude 这样的 AI 助手对 PostgreSQL 数据库进行语义搜索，为数据库查询带来更智能、便捷的体验。

🚀 快速开始

本服务器将 Claude（或其他兼容的 AI 助手）与 PostgreSQL 数据库相连，实现语义搜索功能。用户可以用自然语言提问，服务器会理解问题并执行相应的 SQL 查询，返回结果。

✨ 主要特性

什么是 MCP？

模型上下文协议（MCP）是由 Anthropic 开发的开源标准，它借助客户端 - 服务器架构，为 AI 模型与外部系统（如数据库、内容存储库和业务工具）的交互提供了标准化方式，让 AI 助手能连接到数据所在的外部系统。

这个 MCP 服务器的功能

• 语义理解数据库结构：服务器运用向量嵌入技术，深入理解表和列的意义与目的，而非仅依据名称。
• 执行自然语言查询：用户使用简单英语提问，即可获取相关 SQL 查询结果。
• 进行混合搜索：结合关键词匹配和语义理解，使查询结果更准确。
• 提供上下文感知的响应：AI 可全面访问数据库模式元数据。

核心功能

• 基于向量的语义搜索：利用 OpenAI 的嵌入技术理解语义含义。
• 元数据驱动：以向量格式存储表和列的丰富描述。
• 无需修改现有架构：数据库表保持不变，元数据单独存储。
• 与 Claude Desktop 简单集成：配置过程简便。

📦 安装指南

先决条件

• PostgreSQL 13+ 带 pgvector 扩展
• Node.js 18+
• OpenAI API 密钥（用于生成嵌入）
• Claude Desktop（或其他兼容的客户端）

安装步骤

1. 数据库设置

先安装 PostgreSQL 和 pgvector 扩展，再运行 schema.sql 脚本创建必要的表和示例数据：

psql -U postgres -f schema.sql

2. MCP 服务器设置

# 克隆此仓库
git clone https://github.com/cpenniman12/semantic-postgres-mcp.git
cd semantic-postgres-mcp

# 安装依赖项
npm install

# 配置环境变量
cp .env.example .env
# 使用您的 PostgreSQL 和 OpenAI 凭据编辑 .env 文件

# 启动服务器
npm start

3. 配置 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "semantic-postgres": {
      "command": "node",
      "args": ["/path/to/your/semantic-postgres-mcp/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

重新启动 Claude Desktop 以连接到 MCP 服务器。

💻 使用示例

基础用法

设置完成后，您可以向 Claude 提出如下问题：

# 显示所有客户信息
# 当前库存量低的产品有哪些？
# 查找总价超过 $1000 的订单
# 显示客户与订单之间的关系

Claude 会利用语义搜索功能理解您的请求，找到相关的表和列，并执行适当的 SQL 查询。

📚 详细文档

工作原理

1. 元数据存储：系统存储数据库模式的详细描述（表、列、关系）及其向量嵌入。
2. 查询理解：当您提出问题时，系统将其转换为嵌入并找到语义相似的列/表。
3. SQL 生成：根据匹配的元数据生成适当的 SQL 查询。
4. 结果呈现：以清晰易懂的方式展示查询结果。

📄 许可证

文档未提及相关内容，暂不展示。

贡献者

• [您的名字]