jakedismo/kuzumem-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

24 stars 7 forks 品質 58 トレンド 10

Repository Install

TypeScriptで構築されたコードエージェントのKuzuDBを搭載したメモリバンクで、MCPプロトコルに従います

概要

MCP(Model Context Protocol)ツールとして配布されたメモリバンクのTypeScript実装で、リポジトリとブランチフィルタリング機能でメモリを格納します。ブランチの分離は、リポジトリ固有のビューとブランチ固有のビューを可能にしながら、一元化されたメモリバンクを有効にして、エンティティティのためのグラフ一元識別子を使用して達成されます。 IDEやAIエージェントとのシームレスな統合を実現するMCP仕様に完全対応 - - インテリジェントなメモリ管理のためのMCPサンプリング付き高度な推論モデル(OpenAI o3/o4-mini、Claude 4) - - 保証されたロールバック機能を備えた自動スナップショットシステム - MCPサンプリングは、適応最適化戦略のための実際のメモリ状態を分析 - - すべてのメモリバンク操作をカバーする12の統合ツール - 各リソースは、適切なスレッド安全で1回だけインスタンス化されていることを確認してください - KùDBグラフを使用して高度なメモリバンクの仕様に従ってください - すべてのリポジトリは、ブランチと使用 - すべてのリポジトリを使用して - - - - - - - - - - - - - - - - - -.

概要（AI 翻訳）

MCP (Model Context Protocol) ツールとして配布されたメモリバンクの TypeScript 実装で、リポジトリとブランチのフィルタリング機能で、KùzuDB グラフデータベース に保存します。ブランチの分離は、リポジトリ固有のビューとブランチ固有のビューを可能にしながら、一元化されたメモリバンクを有効にして、エンティティティのためのグラフ一元識別子を使用して達成されます。 IDEやAIエージェントとのシームレスな統合を実現するMCP仕様に完全対応

主な特長

-AI-Powered Memory Optimization - インテリジェントなメモリ管理のためのMCPサンプリング付き高度な推論モデル(OpenAI o3/o4-mini、Claude 4)

️️ 生産準備安全 - 保証されたロールバック機能の自動スナップショットシステム
** 参照コンテキスト・アウェアインテリジェンス** - MCPサンプリングは、適応最適化戦略の実際のメモリ状態を分析します -**** ユニファイドツールアーキテクチャ** - すべてのメモリバンク操作をカバーする12の統合ツール
** ** スレッドセーフシングルトンパターン** - 各リソースは、適切なスレッドの安全で1回だけインスタンス化されていることを確認します。
** 分散グラフ構造** - KùzuDBグラフを使用して高度なメモリ銀行仕様に従ってください

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

KuzuMem-MCP

A TypeScript implementation of a distributed memory bank as an MCP (Model Context Protocol) tool, storing memories in a KùzuDB graph database with repository and branch filtering capabilities. Branch isolation is achieved by using a graph-unique identifier for entities, enabling a centralized memory bank while allowing repository-specific and branch-specific views. Fully compliant with MCP specification for seamless integration with IDEs and AI agents.

Key Features

🧠 AI-Powered Memory Optimization - Advanced reasoning models (OpenAI o3/o4-mini, Claude 4) with MCP sampling for intelligent memory management
🛡️ Production-Ready Safety - Automatic snapshot system with guaranteed rollback capabilities
🎯 Context-Aware Intelligence - MCP sampling analyzes actual memory state for adaptive optimization strategies
🔧 Unified Tool Architecture - 12 consolidated tools covering all memory bank operations
🧵 Thread-Safe Singleton Pattern - Ensures each resource is instantiated only once, with proper thread safety
📊 Distributed Graph Structure - Follows the advanced memory bank specification using a KùzuDB graph
🌿 Repository & Branch Awareness - All operations are contextualized by repository name and branch
⚡ Asynchronous Operations - Uses async/await for better performance
🔌 Multiple Access Interfaces - Access via CLI and multiple MCP server implementations
💾 KùzuDB Backend - Utilizes KùzuDB for graph-based memory storage and querying
✅ Fully MCP Compliant - All tools follow the Model Context Protocol for client integration
📡 Progressive Results Streaming - Supports streaming for long-running graph operations
🏠 Client Project Root Isolation - Each client project gets its own isolated database instance
🧠 High-Reasoning Analysis - Leverages OpenAI HIGH reasoning and Anthropic extended thinking for memory optimization
🗑️ Safe Bulk Operations - Advanced bulk deletion with dependency validation and dry-run capabilities

Unified Tools

The system currently broadcasts 12 unified tools that consolidate all memory bank operations:

memory-bank - Initialize and manage memory bank metadata
entity - Create, update, delete, and retrieve all entity types (components, decisions, rules, files, tags)
introspect - Explore graph schema and metadata
context - Manage work session context
query - Unified search across contexts, entities, relationships, dependencies, governance, history, and tags
associate - Create relationships between entities
analyze - Run graph algorithms (PageRank, K-Core, Louvain, Shortest Path)
detect - Detect patterns (strongly/weakly connected components)
bulk-import - Efficient bulk entity import
search - Full-text search across all entity types with KuzuDB FTS integration

GitHub で README 全文を見る

インストール

npx -y ts-node /absolute/path/to/kuzumem-mcp/src/mcp-stdio-server.ts

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "KuzuMem-MCP": {
      "command": "npx",
      "args": ["-y", "ts-node", "/absolute/path/to/kuzumem-mcp/src/mcp-stdio-server.ts"],
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "DB_FILENAME": "memory-bank.kuzu",
        "HTTP_STREAM_PORT": "3001"
      }
    }
  }
}