# open-zk-kb

A local memory layer for AI assistants that carries decisions, preferences, and corrections into later sessions. Useful when project context keeps getting repeated.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: mrosnerr
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mrosnerr/open-zk-kb
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/mcp/open-zk-kb

## What it does

open-zk-kb stores knowledge as linked Zettelkasten notes. A note can capture a decision, preference, or project-specific edge case. Through MCP, the assistant can save information, search the vault, load relevant context, and inspect its status.

Search joins SQLite FTS5 with local MiniLM-L6-v2 vector embeddings. Markdown files are the canonical records, while SQLite can be rebuilt as an index. The data stays on the machine, and local embeddings work without an API key.

The quick installer needs Bun, so `bunx open-zk-kb@latest` will not run without it. The vault remains readable and editable as Markdown, with version control available; the server can also be connected to Claude Code and other MCP clients.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add open-zk-kb -- npx -y open-zk-kb
```

### Codex

**Platform CLI**
```bash
codex mcp add open-zk-kb -- npx -y open-zk-kb
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "open-zk-kb": {
            "command": "npx",
            "args": [
                "-y",
                "open-zk-kb"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "open-zk-kb": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "open-zk-kb"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add open-zk-kb npx -y open-zk-kb
```

## When to use it
- carry corrections between agent sessions
- share project context across AI clients
- retrieve related decisions by meaning
- keep an editable Markdown knowledge vault

## Example prompts
- Save this project convention so you can follow it in future sessions.
- Search the vault for decisions related to error handling in this module.
- Show the active preferences for this project.

## Similar
- [sqlite-graph-memory](https://affpapa.org/en/nevibecode/mcp/sqlite-graph-memory.md) — MCP server · ★ 12
- [tinycontext](https://affpapa.org/en/nevibecode/mcp/tinycontext.md) — MCP server · ★ 9
- [CPersona](https://affpapa.org/en/nevibecode/mcp/cpersona.md) — MCP server · ★ 9
- [melchizedek](https://affpapa.org/en/nevibecode/mcp/melchizedek.md) — MCP server · ★ 7
- [Pensyve](https://affpapa.org/en/nevibecode/mcp/pensyve.md) — MCP server · ★ 97
- [clude](https://affpapa.org/en/nevibecode/mcp/clude.md) — MCP server · ★ 22

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md