Memory PostgreSQL

🚀 MCP メモリサーバー

このサーバーは、AI アシスタントに長期記憶機能を実装するためのものです。mem0 原理を採用し、PostgreSQL と pgvector を使用して、効率的なベクトル類似度検索を行います。

✨ 主な機能

• PostgreSQL と pgvector を使用したベクトル類似度検索
• BERT を使用した自動埋め込み（embedding）生成
• メモリ操作のための RESTful API 提供
• 意味検索機能を備えている
• 複数のタイプのメモリ（学習、経験など）をサポート
• タグベースのメモリ検索
• メモリの信頼度評価
• Server-Sent Events (SSE) を使用したリアルタイム更新
• Cursor MCP プロトコルと互換性がある

📦 インストール

前提条件

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

💻 使用例

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：更新日時