Claude Code Agentic Semantic Memory System MCP

Claude Codeに持続的な意味記憶能力を提供するMCPサーバーで、セッションをまたいだ情報の保存と意味検索をサポートし、ローカル埋め込みとPostgreSQLデータベースを使用します。

知識管理と記憶開発者ツール #意味記憶 #知識管理 #オフライン埋め込み #プロジェクト分離 .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 7.5K

更新時間 : 2025-12-12

サイトを開く

什么是Claude Code Agentic Semantic Memory System?

これはClaude Code用に設計されたインテリジェントな記憶システムで、AIアシスタントが人間のように情報を記憶できるようにします。Claudeが異なるセッション間で重要な情報（プロジェクトのコンテキスト、ユーザーの嗜好、技術的な決定など）を保存および検索できるようにし、本当の持続的な学習とパーソナライズされた体験を実現します。

如何使用语义记忆系统?

システムはClaude CodeのMCPプロトコルを通じて統合され、インストール後は会話の中で自然に使用できます。Claudeに何を記憶するかを直接伝えることも、以前に話し合った内容を尋ねることもできます。システムは記憶の保存、整理、検索を自動的に処理します。

适用场景

長期的な協力が必要なプログラミングプロジェクト、個人学習アシスタント、技術文書の整理、チームの知識ベースの構築などのシナリオに適しています。特に、AIアシスタントがプロジェクトの履歴、技術的な決定、個人の嗜好を記憶できることを望む開発者に適しています。

主要功能

持久记忆

情報はClaude Codeのセッション間で永続的に保存され、再起動や閉じる操作で失われることはありません。

语义搜索

キーワードではなく意味に基づいて検索するため、異なる表現を使用しても関連する記憶を見つけることができます。

项目命名空间

異なるプロジェクトに独立した記憶空間を作成し、情報を整理します。

本地嵌入

完全にローカルで実行される埋め込み生成で、外部APIを必要とせず、プライバシーを保護し、オフラインでも使用できます。

记忆关联

記憶間の関連を作成し、知識グラフを構築し、情報間の関係を理解します。

意图激活

自然言語で自動的なツール呼び出しをトリガーし、複雑なコマンドを覚える必要がありません。

完整CRUD操作

完全な作成、読み取り、更新、削除操作で、記憶内容を完全に制御できます。

隐私优先

すべてのデータはあなた自身のPostgreSQLデータベースに保存され、データの安全性が確保されます。

优势

セッションをまたいだ記憶：AIアシスタントが以前の会話と決定を記憶できます。

意味理解：意味に基づく検索で、よりインテリジェントな情報検索が可能です。

完全なオフライン：ローカルでの埋め込み生成で、ネットワーク接続が不要です。

データセキュリティ：すべてのデータはあなたが管理するデータベースに保存されます。

使いやすさ：自然言語での対話で、複雑なコマンドを学習する必要がありません。

高度なカスタマイズ性：プロジェクトの分離とパーソナライズされた設定をサポートします。

局限性

PostgreSQLデータベースが必要：追加でデータベース環境を設定する必要があります。

ローカル埋め込みの精度が有限：クラウドの大規模モデルと比較すると、意味理解がやや弱い場合があります。

初期設定が複雑：環境変数の正しい設定とマイグレーションの実行が必要です。

リソース消費：ローカル埋め込み生成には一定の計算リソースが必要です。

学習曲線：記憶システムのベストプラクティスを理解する必要があります。

如何使用

安装依赖

Node.js 18+とPostgreSQLデータベース（Neonの使用を推奨）がインストールされていることを確認してください。

复制MCP服务器

MCPサーバーのディレクトリをあなたのClaude設定ディレクトリにコピーしてください。

配置环境

データベース接続とその他の環境変数を設定してください。

运行数据库迁移

データベースのテーブル構造を初期化します。

注册到Claude Code

MCPサーバーをClaude Codeの設定に追加してください。

验证连接

MCPサーバーが正しく接続されていることを確認してください。

使用案例

记住用户偏好

Claudeにあなたのプログラミングの嗜好を記憶させ、将来のセッションでよりパーソナライズされた提案を得ることができます。

检索项目决策

以前話し合った技術的な決定を探し、繰り返しの議論を避けます。

保存代码规范

特定のプロジェクトにコード規約の要求を保存し、一貫性を確保します。

跨项目切换

異なるプロジェクト間で切り替え、記憶を分離します。

常见问题

这个系统会存储我的敏感信息吗？

我需要一直保持网络连接吗？

记忆会占用很多存储空间吗？

如何备份我的记忆？

可以同时用于多个项目吗？

如果数据库连接失败怎么办？

🚀 Claude Code エージェンティックセマンティックメモリシステム (MCP)

この高度なモデルコンテキストプロトコル (MCP) サーバーは、Claude Codeに永続的なセマンティックメモリ機能を提供し、セッションをまたいだ長期的な情報の保存と検索を可能にします。このシステムにより、Claudeは会話間でコンテキスト、設定、重要な情報を記憶することができます。

✨ 主な機能

🧠 永続的なメモリ：Claude Codeのセッションをまたいで情報が保存されます。
🔍 セマンティック検索：キーワードだけでなく、意味に基づいてメモリを検索できます。
📁 プロジェクト名前空間：メモリを別々のコンテキストやプロジェクトに整理できます。
🌐 ローカル埋め込み：外部APIに依存せずにオフラインで動作します。
🔗 メモリ関係：関連するメモリを接続して知識グラフを作成できます。
🚀 意図ベースのアクティベーション：自然言語で自動的にツールを呼び出すことができます。
📊 完全なCRUD操作：メモリの作成、読み取り、更新、削除が可能です。
🔐 プライバシー重視：すべてのデータは独自のPostgreSQLデータベースに保存されます。

🏗️ アーキテクチャ

コアコンポーネント

agentic-memory/
├── src/
│   ├── index.ts           # MCPサーバーのエントリーポイント
│   ├── db/
│   │   ├── client.ts      # データベース接続 (Neon PostgreSQL)
│   │   └── schema.ts      # Drizzle ORMスキーマ (メモリ、関係)
│   └── tools/
│       ├── createMemory.ts    # 新しいメモリを保存
│       ├── searchMemory.ts    # セマンティック検索
│       ├── listMemories.ts    # メモリの一覧とフィルタリング
│       ├── deleteMemory.ts    # メモリを削除
│       ├── updateMemory.ts    # 既存のメモリを修正
│       ├── manageProjects.ts  # プロジェクト名前空間の管理
│       └── simpleEmbedding.ts # ローカル埋め込みの生成
├── run-server.sh          # サーバー起動スクリプト
└── .env                   # 環境設定

動作原理

Claude Code がstdioを介してMCPサーバーにリクエストを送信します。
MCPサーバー がツールリクエスト（メモリの作成、検索、削除）を処理します。
埋め込み は数学的アルゴリズムを使用してローカルで生成されます。
PostgreSQL (Neon) がpgvectorを使用してメモリを保存し、セマンティック検索を行います。
Drizzle ORM がデータベース操作とマイグレーションを管理します。

🚀 クイックスタート

前提条件

Node.js 18以上
pgvector拡張機能を持つPostgreSQLデータベース (Neonを推奨)
Claude Code CLIがインストールされていること

インストール

このMCPサーバーをプロジェクトにコピーします。

cp -r /path/to/agentic-memory /your/project/.claude/mcp-servers/

依存関係をインストールします。

cd /your/project/.claude/mcp-servers/agentic-memory
npm install

環境変数を設定します。

cp .env.example .env
# .envをデータベースURLで編集します。

データベースマイグレーションを実行します。

npm run db:migrate

Claude Codeに追加します。

claude mcp add agentic-memory ./run-server.sh

接続を確認します。

claude mcp list
# agentic-memory - ✓ Connected と表示されるはずです。

💻 使用例

基本的な使用法

利用可能なMCPツールは以下の通りです。

ツール	説明	使用例
`create_memory`	新しい情報を保存	"ユーザーがTypeScriptを好むことを覚えておく"
`search_memory`	関連するメモリを検索	"ユーザーの設定について何を知っているか？"
`list_memories`	すべてのメモリを表示	"現在のプロジェクトのすべてのメモリを表示"
`delete_memory`	特定のメモリを削除	"IDがxyzのメモリを削除"
`update_memory`	既存のメモリを修正	"場所情報を更新"
`switch_project`	メモリ名前空間を変更	"プロジェクト 'work' に切り替える"
`list_projects`	すべてのプロジェクトを表示	"存在するプロジェクトは何か？"
`delete_project`	プロジェクト全体を削除	" 'test' プロジェクトを削除"

高度な使用法

CLAUDE.md ファイルは準オーケストレーターとして機能し、以下を提供します。

コンテキスト指示：メモリ使用の高レベルなルール
専門エージェント：Claude Codeが呼び出せるメモリエージェント
不変性原則：メモリは追加のみ
品質ガイドライン：高いシグナルを持つ再利用可能な情報のみを保存

例としての CLAUDE.md パターン：

# プロジェクトコンテキスト: [あなたのプロジェクト名]

このプロジェクトは高度なセマンティックメモリシステムを使用して、時間とともに学習し改善します。

## 主要な機能
- **セマンティックメモリ**：長期的なメモリ保存と検索
- **専門エージェント**：メモリ操作のための専用エージェント

## コア原則
- **不変のメモリ**：作成されたメモリは変更されない
- **高シグナルのみ**：再利用可能な、明白でない情報のみを保存
- **機密情報なし**：APIキー、パスワード、個人情報を決して保存しない

📚 ドキュメント

設定

環境変数

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

# PostgreSQL接続 (必須)
DATABASE_URL=postgresql://user:pass@host/db?sslmode=require

# オプション: 埋め込み設定
EMBEDDING_MODEL=simple  # または 'llama' を高度な設定として使用
EMBEDDING_DIMENSIONS=1536

# オプション: デフォルトプロジェクト
DEFAULT_PROJECT=default