MCP server exposing a markdown vault as an agent memory substrate — vault is truth, DuckDB index is disposable, writes are constrained verbs
View on GitHub ↗An MCP server that exposes a markdown vault (Obsidian-style: YAML frontmatter + [[wiki-links]]) as a shared memory substrate for coding/research agents — Claude Code, Gemini CLI, Codex, or anything else that speaks MCP.
- The vault is the source of truth. Durable, human-readable markdown files, versioned by git/jj. The server never stores state anywhere else. - The DuckDB index is disposable infrastructure. Frontmatter and wiki-links are parsed into an in-memory DuckDB database that backs search filters, related, and query. It is rebuilt from the files on demand (30s TTL, invalidated on every write) and is never authoritative. - Writes are constrained verbs, never arbitrary file writes. Each write tool targets one convention-enforced location (an atomic note, an inbox item, a journal log line). Version control is the safety net.
The rule that matters more than the machinery, baked into the server's MCP instructions so every connected agent receives it:
The vault is a collection of durable, human-readable artifacts — not an agent transcript store. Do not create memories merely because information appeared in a conversation. Write a memory only when it represents a durable fact, decision, idea, relationship, or useful piece of project context.
Tool Kind What it does --- --- --- search(query, type?, tag?, match?, limit?) read ranked (default): BM25 over title+body with score + snippet lines; exact/regex: ripgrep line matches with line numbers readnote(nameorpath) read resolve a vault-relative path, note name, or frontmatter alias (typos auto-correct above 0.95 similarity;
From the project README.
Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:
[](https://mcp.liqiwa.com/s/seandavi--vault-mcp.html)
An OKF-backed Model Context Protocol (MCP) server delivering persistent long-term memory and SQLite FTS5 search for AI agents.
sosoj92/jarvis-assistant-vocalAssistant vocal local en francais : Claude ou Ollama (offline), domotique Hue, OBS, agenda, navigateur, appels Twilio, serveur MCP. Python.
Stupidoodle/swissdevjobs-cliSearch & apply to ~4,700 salary-transparent tech jobs across 7 countries (🇨🇭🇩🇪🇬🇧🇺🇸🇨🇦🇳🇱🇫🇷) from your terminal or AI agent — zero-dependency Python CLI + MCP server + Claude Code plugin
agents-universe/agents-universe让智能体像人一样学习和工作，共享智能体和项目记忆
bybit-exchange/kaasTurn scattered notes, docs and transcripts into a queryable Markdown wiki — an LLM knowledge-base compiler with MCP access, no embeddings, self-hosted.
alxgntv/substack-api-mcpMCP server for Substack posts (FastMCP + substack-api-client)
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.