MCP メモリサーバー

このサーバーは、効率的なベクトル類似性検索を実現する pgvector を備えた PostgreSQL を搭載し、mem0 原則を使用して AI アシスタントの長期記憶機能を実装します。

特徴

• ベクトル類似性検索のためのpgvectorを使用したPostgreSQL

• BERTを使用した自動埋め込み生成

• メモリ操作用のRESTful API

• セマンティック検索機能

• さまざまな種類の記憶（学習、経験など）のサポート

• タグベースの記憶検索

• 記憶の信頼度スコア

• リアルタイム更新のためのサーバー送信イベント（SSE）

• カーソルMCPプロトコル対応

Related MCP server: MCPMem

前提条件

1. pgvector 拡張機能がインストールされた PostgreSQL 14+:

# In your PostgreSQL instance:
CREATE EXTENSION vector;

2. Node.js 16以上

設定

1. 依存関係をインストールします:

npm install

2. 環境変数を設定します.env.sampleを.envにコピーし、値を調整します。

cp .env.sample .env

.env構成の例:

# With username/password
DATABASE_URL="postgresql://username:password@localhost:5432/mcp_memory"
PORT=3333

# Local development with peer authentication
DATABASE_URL="postgresql:///mcp_memory"
PORT=3333

3. データベースを初期化します。

npm run prisma:migrate

4. サーバーを起動します。

npm start

自動リロードを使用した開発の場合:

npm run dev

カーソルの使用

カーソルにMCPサーバーを追加する

Cursor にメモリサーバーを追加するには、 ~/.cursor/mcp.json mcpServersある 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. カーソルを開く

2. カーソルが起動するとメモリサーバーが自動的に起動します

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 is a web application framework for Node.js"
  },
  "source": "documentation",
  "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=learning&tags=nodejs,web-framework

健康チェック

GET /mcp/v1/health

応答フォーマット

すべての API 応答は標準の MCP 形式に従います。

{
  "status": "success",
  "data": {
    // Response data
  }
}

またはエラーの場合:

{
  "status": "error",
  "error": "Error message"
}

メモリスキーマ

• id: 一意の識別子

• タイプ: 記憶の種類（学習、経験など）

• コンテンツ: 実際のメモリ内容 (JSON)

• 出典: 記憶の源

• 埋め込み: コンテンツのベクトル表現（384次元）

• tags: 関連タグの配列

• 信頼度: 信頼度スコア (0-1)

• createdAt: メモリが作成された時刻

• 更新日時: メモリが最後に更新された日時