Postg Mem

🚀 PostgMem

PostgMemは、モデルコンテキストプロトコル（MCP）に基づくサーバー実装で、PostgreSQLとpgvectorを使用してAIアプリケーションにベクトルメモリストレージを提供します。

🚀 クイックスタート

PostgMemは、AIエージェントが記憶を保存、検索、および類似度検索でアクセスできるようにする.NETベースのサービスです。PostgreSQLとpgvector拡張機能を利用して、効率的な類似度検索機能を提供します。

✨ 主な機能

• ベクトル埋め込みを使用して構造化された記憶を保存します。
• IDで単一の記憶を検索します。
• ベクトルの類似性による意味検索を行います。
• タグを使用して検索結果をフィルタリングします。
• モデルコンテキストプロトコル（MCP）と統合されており、AIエージェントとの使用が容易です。

🔧 技術詳細

• .NET 9.0
• pgvector拡張機能付きのPostgreSQL
• モデルコンテキストプロトコル（MCP）
• ASP.NET Core
• NpgsqlによるPostgreSQL接続の実装

📦 インストール

前提条件

• .NET 9.0 SDK
• pgvector拡張機能がインストールされたPostgreSQLデータベース
• テキスト埋め込みAPI（デフォルト設定ではOllamaを使用）

設定

データベース設定

1. アプリケーション用のPostgreSQLデータベースを作成します。
2. データベースにpgvector拡張機能をインストールします。

   CREATE EXTENSION vector;
   

3. memoriesテーブルを作成します。

   CREATE TABLE memories (
       id UUID PRIMARY KEY,
       type TEXT NOT NULL,
       content JSONB NOT NULL,
       source TEXT NOT NULL,
       embedding VECTOR(384) NOT NULL,
       tags TEXT[] NOT NULL,
       confidence DOUBLE PRECISION NOT NULL,
       created_at TIMESTAMP WITH TIME ZONE NOT NULL,
       updated_at TIMESTAMP WITH TIME ZONE NOT NULL
   );
   

環境設定

プロジェクトの .env ファイルでアプリケーションの設定を構成します。

ConnectionStrings__Storage="Host=localhost;Database=mcp_memory;Username=postgres;Password=postgres"
Embeddings__ApiUrl=http://localhost:11434/
Embeddings__Model=all-minilm:33m-l12-v2-fp16

• ConnectionStrings__Storage：PostgreSQL接続文字列
• Embeddings__ApiUrl：埋め込みAPIのURL（デフォルトではOllamaを使用）
• Embeddings__Model：使用する埋め込みモデル

アプリケーションの実行

1. PostgMemディレクトリに切り替えます。
2. アプリケーションを実行します。

   dotnet run
   

3. MCPサーバーは http://localhost:5000 でデフォルトで利用可能になります。

💻 使用例

MCPツール

保存

新しい記憶をデータベースに保存します。

• type（文字列）：記憶のタイプ（例：'会話'、'ドキュメント' など）
• content（文字列）：JSONオブジェクトとしての記憶内容
• source（文字列）：記憶のソース（例：'ユーザー'、'システム' など）
• tags（文字列配列）：オプションの記憶分類タグ
• confidence（倍精度浮動小数点数）：記憶の信頼度スコア（0.0 から 1.0）

検索

提供されたテキストで類似する記憶を検索します。

• query（文字列）：検索するテキスト
• limit（整数）：返される結果の最大数（デフォルト：10）
• minSimilarity（倍精度浮動小数点数）：最小類似度閾値（0.0 から 1.0）（デフォルト：0.7）
• filterTags（文字列配列）：オプションの記憶フィルタリングタグ

取得

IDで特定の記憶を検索します。

• id（Guid）：検索する記憶のID

削除

IDで記憶を削除します。

• id（Guid）：削除する記憶のID

🔧 技術詳細

• Memory.cs：記憶データモデルを定義します。
• Storage.cs：データベース操作を処理し、記憶の保存と検索を行います。
• EmbeddingService.cs：テキストベクトル埋め込みを生成します。
• MemoryTools.cs：MCPツールを実装して記憶ストレージとやり取りします。

📄 ライセンス

[ここにライセンス情報を記入してください]

貢献

[該当する場合は、貢献ガイドをここに追加してください]

連絡先

[連絡先またはサポート情報をここに提供してください]