Melchizedek

Persistent memory for Claude Code — offline, single-file, hybrid search.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "melchizedek": {
      "command": "npx",
      "args": [
        "-y",
        "melchizedek-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Melchizedek

Persistent memory for Claude Code. Automatically indexes every conversation and provides production-grade hybrid search (BM25 + vectors + reranker) via MCP tools. 100% local, zero config, zero API keys, zero invoice.

Why Melchizedek?

Claude Code forgets everything between sessions - and knows nothing about your other projects. Melchizedek fixes both.

It runs silently in the background - indexing your conversations as you work - then gives Claude the ability to search across your entire history, across all projects: past debugging sessions, architectural decisions, error solutions, code patterns.

No cloud. No API keys. No config. Plug and ask.

How it works

Code

~/.claude/projects/**/*.jsonl       (your conversation transcripts - read-only)
        |
        v
  SessionEnd hook                   (auto-triggers after each session)
        |
        v
  +-----------------+
  |  Indexer         |    Parse JSONL -> chunk pairs -> SHA-256 dedup
  |  (better-sqlite3)|    FTS5 tokenize -> vector embed (optional)
  +-----------------+
        |
        v
  ~/.melchizedek/memory.db           (single SQLite file, WAL mode)
        |
        v
  +-----------------+
  |  MCP Server      |    16 search & management tools
  |  (stdio)         |    Hybrid: BM25 + vectors + RRF + reranker
  +-----------------+
        |
        v
  Claude Code                       (searches your history via MCP)

Search pipeline - 4 levels of graceful degradation

Every layer is optional. The plugin works with BM25 alone and gets better as more components are available.

Level	Component	What it adds	Dependency
1	BM25 (FTS5)	Keyword search with stemming	None (always active)
2	Dual vectors (sqlite-vec)	Semantic search - text (MiniLM 384d) + code (Jina 768d)	`@huggingface/transformers` (optional)
3	RRF fusion	Merges BM25 + text vectors + code vectors via Reciprocal Rank Fusion	Vectors enabled
4	Reranker	Cross-encoder re-scoring of top results	Transformers.js or node-llama-cpp (optional)

Performance

Measured with npm run bench - 100 sessions, 1 000 chunks, on a single SQLite file.

Metric	Result	Target
Indexation (100 sessions)	~80 ms	< 10 s
BM25 search (mean)	~0.2 ms	< 50 ms
DB size (100 sessions)	~1.4 MB	< 30 MB
Tokens per search	~125	< 2 000

Quick Start

npm (recommended)

Terminal

npm install -g melchizedek

Add the MCP server to Claude Code:

Terminal

claude mcp add --scope user melchizedek -- melchizedek-server

npx (no install)

Terminal

claude mcp add --scope user melchizedek -- npx melchizedek-server

From source

bash

git clone https://github.com/louis49/melchizedek.git
cd melchizedek && npm install && npm run build
claude --mcp-config .mcp.json

Claude Code plugin marketplace (coming soon)

Plugin review pending. In the meantime, use npm or npx install above.

Terminal

claude plugin install melchizedek   # not yet available

Setting up hooks (automatic indexing)

The MCP server provides search tools, but hooks trigger automatic indexing. Without hooks, you'd need to manually index sessions.

For marketplace installs, hooks are configured automatically. For npm/npx/source installs, add hooks to ~/.claude/settings.json.

See docs/installation.md for the full JSON configuration, hook reference, and troubleshooting.

After setup, restart Claude Code. Indexing starts automatically.

MCP Tools

Search (start here)

Tool	Description
`m9k_search`	Search indexed conversations. Returns compact snippets. Current project boosted. Supports `since`/`until` date filters and `order` (score, date_asc, date_desc).
`m9k_context`	Get a chunk with surrounding context (adjacent chunks in the same session).
`m9k_full`	Retrieve full content of chunks by IDs.

Progressive retrieval pattern - search returns ~50 tokens/result, context ~200-300, full ~500-1000. Start with m9k_search, drill down only when needed. 4x token savings vs loading everything.

Context-aware ranking - results from your current project (×1.5) and current session (×1.2) are automatically promoted. Cross-project results remain visible.

Specialized search

Tool	Description
`m9k_file_history`	Find past conversations that touched a specific file.
`m9k_errors`	Find past solutions for an error message.
`m9k_similar_work`	Find past approaches to similar tasks. Prioritizes rich metadata.

Memory management

Tool	Description
`m9k_save`	Manually save a memory note for future recall.
`m9k_sessions`	List all indexed sessions, optionally filtered by project.
`m9k_info`	Show memory index info: corpus size, search pipeline, embedding worker, usage metrics.
`m9k_config`	View or update plugin configuration.
`m9k_forget`	Permanently remove a chunk from the index.
`m9k_delete_session`	Delete a session from the index.
`m9k_ignore_project`	Exclude a project from indexing. Future sessions won't be indexed, existing ones optionally purged.
`m9k_unignore_project`	Re-enable indexing for a previously ignored project. Purged data is not restored.
`m9k_restart`	Restart the MCP server to load fresh code after `npm run build`. Supports `force: true` for stuck processes.

Usage guide

Tool	Description
`__USAGE_GUIDE`	Phantom tool. Its description teaches Claude the retrieval pattern and available tools.

Configuration

Zero config by default. Everything is tunable via m9k_config or environment variables.

Setting	Default	Env var
Database path	`~/.melchizedek/memory.db`	`M9K_DB_PATH`
Daemon mode	enabled	`M9K_NO_DAEMON=1` to disable
Log level	`warn`	`M9K_LOG_LEVEL`
Embeddings enabled	`true`	`M9K_EMBEDDINGS=false` to disable
Reranker enabled	`true`	`M9K_RERANKER=false` to disable

See docs/configuration.md for the full settings reference (20+ options, env vars, config file examples).

Enhanced Search

Melchizedek works out of the box with BM25 keyword search. Text embeddings (MiniLM) download automatically on first use for semantic search.

For GPU-accelerated code embeddings (Ollama), cross-encoder reranking (GGUF models), platform-specific setup guides, and the full model reference, see Enhanced Search Setup.

How is this different?

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Melchizedek

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "melchizedek": { "command": "npx", "args": ["-y", "melchizedek"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/melchizedek?style=directory)](https://allmcps.com/mcp/melchizedek)

HTML Embed

<a href="https://allmcps.com/mcp/melchizedek"><img src="https://allmcps.com/api/badge/melchizedek?style=directory" alt="Melchizedek on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Melchizedek →Install in Claude Desktop Install in Cursor Install in VS Code

Melchizedek

Persistent memory for Claude Code — offline, single-file, hybrid search.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "melchizedek": {
      "command": "npx",
      "args": [
        "-y",
        "melchizedek-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Melchizedek

Why Melchizedek?

Claude Code forgets everything between sessions - and knows nothing about your other projects. Melchizedek fixes both.

No cloud. No API keys. No config. Plug and ask.

How it works

Code

~/.claude/projects/**/*.jsonl       (your conversation transcripts - read-only)
        |
        v
  SessionEnd hook                   (auto-triggers after each session)
        |
        v
  +-----------------+
  |  Indexer         |    Parse JSONL -> chunk pairs -> SHA-256 dedup
  |  (better-sqlite3)|    FTS5 tokenize -> vector embed (optional)
  +-----------------+
        |
        v
  ~/.melchizedek/memory.db           (single SQLite file, WAL mode)
        |
        v
  +-----------------+
  |  MCP Server      |    16 search & management tools
  |  (stdio)         |    Hybrid: BM25 + vectors + RRF + reranker
  +-----------------+
        |
        v
  Claude Code                       (searches your history via MCP)

Search pipeline - 4 levels of graceful degradation

Every layer is optional. The plugin works with BM25 alone and gets better as more components are available.

Level	Component	What it adds	Dependency
1	BM25 (FTS5)	Keyword search with stemming	None (always active)
2	Dual vectors (sqlite-vec)	Semantic search - text (MiniLM 384d) + code (Jina 768d)	`@huggingface/transformers` (optional)
3	RRF fusion	Merges BM25 + text vectors + code vectors via Reciprocal Rank Fusion	Vectors enabled
4	Reranker	Cross-encoder re-scoring of top results	Transformers.js or node-llama-cpp (optional)

Performance

Measured with npm run bench - 100 sessions, 1 000 chunks, on a single SQLite file.

Metric	Result	Target
Indexation (100 sessions)	~80 ms	< 10 s
BM25 search (mean)	~0.2 ms	< 50 ms
DB size (100 sessions)	~1.4 MB	< 30 MB
Tokens per search	~125	< 2 000

Quick Start

npm (recommended)

Terminal

npm install -g melchizedek

Add the MCP server to Claude Code:

Terminal

claude mcp add --scope user melchizedek -- melchizedek-server

npx (no install)

Terminal

claude mcp add --scope user melchizedek -- npx melchizedek-server

From source

bash

git clone https://github.com/louis49/melchizedek.git
cd melchizedek && npm install && npm run build
claude --mcp-config .mcp.json

Claude Code plugin marketplace (coming soon)

Plugin review pending. In the meantime, use npm or npx install above.

Terminal

claude plugin install melchizedek   # not yet available

Setting up hooks (automatic indexing)

The MCP server provides search tools, but hooks trigger automatic indexing. Without hooks, you'd need to manually index sessions.

For marketplace installs, hooks are configured automatically. For npm/npx/source installs, add hooks to ~/.claude/settings.json.

See docs/installation.md for the full JSON configuration, hook reference, and troubleshooting.

After setup, restart Claude Code. Indexing starts automatically.

MCP Tools

Search (start here)

Tool	Description
`m9k_search`	Search indexed conversations. Returns compact snippets. Current project boosted. Supports `since`/`until` date filters and `order` (score, date_asc, date_desc).
`m9k_context`	Get a chunk with surrounding context (adjacent chunks in the same session).
`m9k_full`	Retrieve full content of chunks by IDs.

Progressive retrieval pattern - search returns ~50 tokens/result, context ~200-300, full ~500-1000. Start with m9k_search, drill down only when needed. 4x token savings vs loading everything.

Context-aware ranking - results from your current project (×1.5) and current session (×1.2) are automatically promoted. Cross-project results remain visible.

Specialized search

Tool	Description
`m9k_file_history`	Find past conversations that touched a specific file.
`m9k_errors`	Find past solutions for an error message.
`m9k_similar_work`	Find past approaches to similar tasks. Prioritizes rich metadata.

Memory management

Tool	Description
`m9k_save`	Manually save a memory note for future recall.
`m9k_sessions`	List all indexed sessions, optionally filtered by project.
`m9k_info`	Show memory index info: corpus size, search pipeline, embedding worker, usage metrics.
`m9k_config`	View or update plugin configuration.
`m9k_forget`	Permanently remove a chunk from the index.
`m9k_delete_session`	Delete a session from the index.
`m9k_ignore_project`	Exclude a project from indexing. Future sessions won't be indexed, existing ones optionally purged.
`m9k_unignore_project`	Re-enable indexing for a previously ignored project. Purged data is not restored.
`m9k_restart`	Restart the MCP server to load fresh code after `npm run build`. Supports `force: true` for stuck processes.

Usage guide

Tool	Description
`__USAGE_GUIDE`	Phantom tool. Its description teaches Claude the retrieval pattern and available tools.

Configuration

Zero config by default. Everything is tunable via m9k_config or environment variables.

Setting	Default	Env var
Database path	`~/.melchizedek/memory.db`	`M9K_DB_PATH`
Daemon mode	enabled	`M9K_NO_DAEMON=1` to disable
Log level	`warn`	`M9K_LOG_LEVEL`
Embeddings enabled	`true`	`M9K_EMBEDDINGS=false` to disable
Reranker enabled	`true`	`M9K_RERANKER=false` to disable

See docs/configuration.md for the full settings reference (20+ options, env vars, config file examples).

Enhanced Search

Melchizedek works out of the box with BM25 keyword search. Text embeddings (MiniLM) download automatically on first use for semantic search.

For GPU-accelerated code embeddings (Ollama), cross-encoder reranking (GGUF models), platform-specific setup guides, and the full model reference, see Enhanced Search Setup.

How is this different?

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Melchizedek

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "melchizedek": { "command": "npx", "args": ["-y", "melchizedek"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/melchizedek?style=directory)](https://allmcps.com/mcp/melchizedek)

HTML Embed

<a href="https://allmcps.com/mcp/melchizedek"><img src="https://allmcps.com/api/badge/melchizedek?style=directory" alt="Melchizedek on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity3/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Melchizedek →Install in Claude Desktop Install in Cursor Install in VS Code