Long Term Memory

🚀 記憶 MCP サーバー

長期記憶を保存するシステムで、大規模言語モデル (LLMs) 用に設計され、Model Context Protocol (MCP) 標準を採用しています。このシステムは、LLMs が複数のセッションにまたがっても、プロジェクト全体の履歴におけるコンテキスト情報を記憶するのを支援します。意味検索と埋め込みベクトル技術を利用して、過去の対話や決定に関連するコンテキストを提供します。

✨ 主な機能

• プロジェクトベースの記憶管理：プロジェクトごとに記憶を管理します。
• 意味検索：Ollama の埋め込み（nomic-embed-text モデル、768 次元）を使用します。
• 複数の記憶タイプ：
  • 会話：会話のコンテキストと重要な議論
  • コード：実装の詳細と変更
  • 決定：重要なアーキテクチャと設計の選択
  • 参照：外部リソースとドキュメントのリンク
• 豊富なメタデータ保存：
  • 実装状態
  • 重要な決定
  • 作成/変更されたファイル
  • コードの変更
  • 追加された依存関係
• タグシステム：記憶を整理するために使用します。
• 関係追跡：記憶間の関係を追跡します。

📦 インストール

前提条件

• Node.js (v18 以上)
• ローカルで Ollama を実行（埋め込み用）
  • nomic-embed-text モデルをインストールする必要があります。
• SQLite3

インストール手順

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. 設定ファイル .env を作成します。

   OLLAMA_HOST=http://localhost:11434
   DB_PATH=memory.db
   

💻 使用例

基本的な使用法

1. 開発モードでサーバーを起動します。

   npm run dev
   

   これにより、以下のことが行われます。
   • TypeScript をコンパイルします。
   • schema ファイルをコピーします。
   • 自動リロード機能付きでサーバーを起動します。
2. 標準入出力を介して Cursor と互換性のある接続を行います。

高度な使用法

1. インストール後、環境変数を設定します。

   export OLLAMA_HOST=http://localhost:11434
   export DB_PATH=memory.db
   

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

   npm run dev
   

3. ツールを使用します。
   • 記憶を保存します。

     nomic store-dev-memory --content "これはテスト用の記憶です" --tags test,example
     

   • 記憶を一覧表示します。

     nomic list-dev-memories
     

   • 記憶を検索します。

     nomic search --query example
     

📚 ドキュメント

データベース構造

システムは SQLite を使用し、以下のテーブルを含みます。

コアテーブル

• projects：プロジェクト情報とメタデータ
• memories：さまざまな開発コンテキストの記憶エントリを保存
• embeddings：意味検索用の埋め込みベクトル（768 次元）

組織テーブル

• tags：記憶を整理するためのタグ
• memory_tags：記憶とタグの多対多の関係
• memory_relationships：記憶エントリ間の有向関係

MCP ツール

以下のツールは MCP プロトコルを通じて利用できます。

記憶管理

• store-dev-memory：新しい開発記憶を作成します。以下を含みます。
  • 内容
  • タイプ（会話/コード/決定/参照）
  • タグ
  • コードの変更
  • 作成/変更されたファイル
  • 重要な決定
  • 実装状態
• list-dev-memories：既存の記憶を一覧表示します。タグでフィルタリングすることもできます。
• get-dev-memory：ID で特定の記憶を取得します。
• search：埋め込みベクトルを使用して、記憶全体で意味検索を行います。

開発環境

開発時には、以下のコマンドを実行します。

npm run dev

これにより、以下のことが行われます。

1. 現在実行中のサーバーインスタンスを終了します。
2. TypeScript コードを再構築します。
3. schema.sql を dist ディレクトリにコピーします。
4. 開発モードでサーバーを起動します。

依存関係

主要な依存関係は以下の通りです。

• @modelcontextprotocol/sdk@^1.7.0：MCP プロトコルの実装
• better-sqlite3@^9.4.3：SQLite データベースのインターフェース
• node-fetch@^3.3.2：Ollama API の HTTP クライアント
• zod@^3.22.4：ランタイムでの型チェックと検証

プロジェクト構造

memory-mcp-server/
├── src/
│   ├── db/
│   │   ├── init.ts     # データベースの初期化
│   │   └── service.ts  # データベースのサービス層
│   ├── memory.js      # 記憶管理のロジック
│   └── search.js      # 意味検索機能
├── package.json       # 依存関係の管理とスクリプト
└── .env               # 環境変数の設定

🔧 技術詳細

注意事項

⚠️ 重要提示

Ollama サービスがローカルで実行され、nomic-embed-text モデルが読み込まれていることを確認してください。 データベースファイル (memory.db) はプロジェクトディレクトリに作成され、記憶データが保存されます。 コードと設定ファイルは具体的なニーズに合わせて調整してください。

貢献ガイド

貢献を歓迎します！ CONTRIBUTING.md を参照して開発に参加してください。