Kuzumem Mcp

Created By

Jokke Ruokolainen7 months ago

Yet another memory system for agents. This one with a coding project focus. My hobby project for learning TypeScript, Graph Databases and MCP. Vibe code 75% so bugs might ensue. Would love some userfeedback and feel free to pitch in with the development. Support both SSE and stdio and the servers are end-to-end tested. Cline and Cursor work with stdio atleast based on my testing. Stack: TypeScript KuzuDB Model-Context-Protocol support (no official SDK yet)

# memory

# agents

Overview Content Tools Comments

Content

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.

Why it's not using the official TypeScript MCP SDK?

The official TypeScript MCP SDK is a great project and we will use it in the future. However, we are using a custom implementation for the following reasons:

To learn the intricacies of the MCP Protocol
To have a more flexible and custom implementation
Wanted to start small with CLI and HTTP server implementation and then add more features later

Features

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, with entities uniquely identified by a composite key (repositoryName:branchName:itemId).
Asynchronous Operations - Uses async/await for better performance
Multiple Access Interfaces - Access via a RESTful HTTP API, a 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.
Modular Architecture - Clear separation between MCP servers, service layer, memory operations, and repositories.
MCP/JSON-RPC Communication - Supports:
- HTTP with per-tool batch-oriented endpoints (src/mcp/server.ts via src/app.ts at /mcp/tools/...).
- HTTP Streaming (SSE) via a unified /mcp endpoint for progressive results (src/mcp-httpstream-server.ts).
- Stdio for direct IDE/Agent integration, supporting both batch and progressive results (src/mcp-stdio-server.ts).
Progressive Results Streaming - Supports tools/progress notifications for long-running graph operations over Stdio and HTTP Streaming.
Graph & Traversal Tools - Includes tools for dependency analysis, pathfinding, and graph algorithms.
Lazy Database Initialization - Databases are only initialized when explicitly requested through the init-memory-bank tool, not during server startup.
Client Project Root Isolation - Each client project gets its own isolated database instance based on the provided project root path.

Server Config

{
  "mcpServers": {
    "KuzuMemo-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "ts-node",
        "/Users/<absolute_path>/kuzumem-mcp/src/mcp-stdio-server.ts"
      ],
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "DB_FILENAME": "memory-bank.kuzu",
        "HTTP_STREAM_PORT": "3001",
        "HTTP_STREAM_PROJECT_ROOT": "/"
      },
      "protocol": "stdio"
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Context7Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors

ChatWiseThe second fastest AI chatbot™

CursorThe AI Code Editor

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Playwright McpPlaywright MCP server

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code