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. 結果呈現：以清晰易懂的方式展示查詢結果。

📄 許可證

文檔未提及相關內容，暫不展示。

貢獻者

• [您的名字]