Memory PostgreSQL

🚀 MCP 內存服務器

MCP 內存服務器專為 AI 助手打造，可實現長期記憶功能。它基於 mem0 原理，藉助 PostgreSQL 和 pgvector 進行高效的向量相似度搜索，為 AI 助手的記憶管理提供了強大支持。

🚀 快速開始

先決條件

1. 安裝 PostgreSQL 14+ 並啟用 pgvector 擴展：

# 在你的 PostgreSQL 實例中：
CREATE EXTENSION vector;

2. Node.js 16+

設置

1. 安裝依賴項：

npm install

2. 配置環境變量： 複製 .env.sample 到 .env 並調整值：

cp .env.sample .env

示例 .env 配置：

# 使用用戶名/密碼
DATABASE_URL="postgresql://username:password@localhost:5432/mcp_memory"
PORT=3333

# 本地開發使用 peer 認證
DATABASE_URL="postgresql:///mcp_memory"
PORT=3333

3. 初始化數據庫：

npm run prisma:migrate

4. 啟動服務器：

npm start

對於帶有自動重載的開發環境：

npm run dev

✨ 主要特性

• 使用 PostgreSQL 和 pgvector 進行向量相似度搜索。
• 自動生成嵌入（embedding）使用 BERT。
• 提供 RESTful API 用於內存操作。
• 具備語義搜索能力。
• 支持多種類型的記憶（學習、經驗等）。
• 標籤-based 的記憶檢索。
• 記憶置信評分。
• 使用 Server-Sent Events (SSE) 實現即時更新。
• 兼容 Cursor MCP 協議。

💻 使用示例

與 Cursor 使用

在 Cursor 中添加 MCP 服務器

要將記憶服務器添加到 Cursor，請修改位於 ~/.cursor/mcp.json 的 MCP 配置文件。在 mcpServers 對象中添加以下配置：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/path/to/your/memory/src/server.js"
      ]
    }
  }
}

將 /path/to/your/memory 替換為實際的記憶服務器安裝路徑。

例如，如果你從倉庫克隆到 /Users/username/workspace/memory，你的配置將如下所示：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/Users/username/workspace/memory/src/server.js"
      ]
    }
  }
}

服務器將在 Cursor 啟動時自動啟動。你可以通過以下步驟驗證其工作狀態：

1. 打開 Cursor。
2. 當 Cursor 啟動時，記憶服務器將自動啟動。
3. 檢查服務器狀態，請訪問 http://localhost:3333/mcp/v1/health。

可用的 MCP 終端

SSE 連接

• 終端：GET /mcp/v1/sse
• 查詢參數：
  • subscribe：要訂閱的事件列表（以逗號分隔，可選）
• 事件：
  • connected：初始連接時發送。
  • memory.created：當創建新記憶時發送。
  • memory.updated：當更新現有記憶時發送。

記憶操作

1. 創建記憶

POST /mcp/v1/memory
Content-Type: application/json

{
  "type": "learning",
  "content": {
    "topic": "Express.js",
    "details": "Express.js 是 Node.js 的網絡應用程序框架"
  },
  "source": "文檔",
  "tags": ["nodejs", "web-framework"],
  "confidence": 0.95
}

2. 搜索記憶

GET /mcp/v1/memory/search?query=web+frameworks&type=learning&tags=nodejs

3. 列出記憶

GET /mcp/v1/memory?type=學習&tags=nodejs,web-framework

健康檢查

GET /mcp/v1/health

響應格式

所有 API 響應均遵循標準的 MCP 格式：

{
  "status": "success",
  "data": {
    // 響應數據
  }
}

或錯誤時：

{
  "status": "error",
  "error": "錯誤信息"
}

📚 詳細文檔

記憶架構

• id：唯一標識符。
• type：記憶類型（學習、經驗等）。
• content：實際記憶內容（JSON 格式）。
• source：來源。
• tags：標籤列表。
• created_at：創建時間。
• updated_at：更新時間。