MMCPMarkets
JK

jakedismo/kuzumem-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

24 stars 7 forks Качество 58 Тренд 10
Repository Install

KuzuDB-powered memory bank for code agents built with TypeScript and follows MCP protocol

Обзор

A TypeScript implementation of a distributed memory bank as an MCP (Model Context Protocol) tool, storing memories in a 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. - - Advanced reasoning models (OpenAI o3/o4-mini, Claude 4) with MCP sampling for intelligent memory management - - Automatic snapshot system with guaranteed rollback capabilities - - MCP sampling analyzes actual memory state for adaptive optimization strategies - - 12 consolidated tools covering all memory bank operations - - Ensures each resource is instantiated only once, with proper thread safety - - Follows the advanced memory bank specification using a KùzuDB graph - - All operations are contextualized by repository name and branch - - Uses...

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:

  1. memory-bank - Initialize and manage memory bank metadata
  2. entity - Create, update, delete, and retrieve all entity types (components, decisions, rules, files, tags)
  3. introspect - Explore graph schema and metadata
  4. context - Manage work session context
  5. query - Unified search across contexts, entities, relationships, dependencies, governance, history, and tags
  6. associate - Create relationships between entities
  7. analyze - Run graph algorithms (PageRank, K-Core, Louvain, Shortest Path)
  8. detect - Detect patterns (strongly/weakly connected components)
  9. bulk-import - Efficient bulk entity import
  10. search - Full-text search across all entity types with KuzuDB FTS integration
Открыть полный README на GitHub

Установка

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" } } } }