
jakedismo/kuzumem-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
TypeScript와 MCP 프로토콜을 따르는 코드 에이전트를 위한 KuzuDB-powered 메모리뱅크
개요
MCP (Model Context Protocol) 도구로 분산 된 메모리 은행의 TypeScript 구현은 저장소 및 분기 필터링 기능으로 기억을 저장합니다. Branch isolation은 entities에 대한 그래프 고유 식별자를 사용하여 중앙 메모리 은행을 활성화하여 저장소 별 및 지점 별보기를 허용합니다. IDE 및 AI Agent와 완벽하게 통합된 MCP 사양을 준수합니다. - - 지능형 메모리 관리를위한 MCP 샘플링과 함께 고급 소싱 모델 (OpenAI o3/o4-mini, Claude 4) - - 보장 된 롤백 기능을 갖춘 자동 스냅 샷 시스템 - MCP 샘플링은 적응 최적화 전략을위한 실제 메모리 상태를 분석합니다 - 12 모든 메모리 은행 운영을 포함하는 통합 된 도구 - 각 리소스가 즉시 완료되면 적절한 스레드 안전과 함께 - - Kzu graphDB를 사용하여 고급 메모리 은행 사양을 따르십시오 - 모든 메모리 은행 운영 - - 모든 필수 항목 및 지점을 재구성하여 ...
개요(AI 번역)
MCP (Model Context Protocol) 도구로 분산 된 메모리 은행의 TypeScript 구현은 ** KùzuDB 그래프 데이터베이스 ** 저장소 및 지점 필터링 기능을 저장합니다. Branch isolation은 entities에 대한 그래프 고유 식별자를 사용하여 중앙 메모리 은행을 활성화하여 저장소 별 및 지점 별보기를 허용합니다. IDE 및 AI Agent와 완벽하게 통합된 MCP 사양을 준수합니다.
키 기능
-** AI AI-Powered Memory Optimization** - 지능형 메모리 관리를위한 MCP 샘플링과 함께 고급 소싱 모델 (OpenAI o3/o4-mini, Claude 4) -️️ Production-Ready Safety - 보장된 롤백 기능을 가진 자동 스냅샷 시스템 -** Con Context-Aware Intelligence** - MCP 샘플링은 적합한 최적화 전략을 위한 실제 메모리 상태를 분석합니다.
- ** Unified Tool Architecture** - 모든 메모리 은행 운영을 포함하는 12개의 통합 도구 -** Single Thread-Safe Singleton Pattern** - 각 리소스를 한 번만 유지하며 적절한 실 안전
- ** Dist Distributed Graph Structure** - 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
설치
npx -y ts-node /absolute/path/to/kuzumem-mcp/src/mcp-stdio-server.ts설정
{
"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"
}
}
}
}