second-brain-mcp
About
Self-maintaining knowledge vault: figure-level search, auto-wikilinks, and sleep-based memory compression.
Details
- Author
- ddmanyes
- Categories
- Database, Knowledge Base, AI, Other
Jump to
Setup
Install second-brain-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/ddmanyes/second-brain-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A self-maintaining personal knowledge base for AI agents — a plain-Markdown vault, powered by MCP.
A local knowledge base your AI agent can read, write, andmaintain on its own. Save a paper or note with one command — second-brain converts it to Markdown, OCRs every figure, embeds it for semantic search, and auto-links it to related notes. Notes you stop reading compress themselves over time, so recall stays cheap as the vault grows.
Everything is plain Markdown — sync via Google Drive / iCloud / git, switch agents anytime,zero lock-in.
- One command saves anything—save_article(url_or_pdf)fetches, converts to Markdown, OCRs figures (Claude Vision), embeds, and auto-links.
- Figure-level search—search_figures("UMAP melanocyte")returns the exact panel across your whole library.
- Self-organizing— new notes auto-link to related ones; frequently-read notes extract reusable rules.
- Memory that forgets like a brain— Ebbinghaus ranking; stale notes auto-compress (60–90% fewer tokens).
- Session continuity—get_context()reloads goals + top notes + rules at the start of every session.
- Pluggable backend— DuckDB (default, offline) or Postgres + pgvector (central, multi-machine). Self-hosted embeddings optional; BM25 fallback when offline.
pip install mcp-second-brain playwright install chromium claude mcp add --scope user second-brain \ --env SECOND_BRAIN_PATH=~/second-brain \ -- python -m mcp_second_brain
The vault directory and templates are created on first run. Then tell your agentinit_vaultto verify.
⚠️ PyPI currently lags the source tree. For the newest build — plus Claude Desktop, Windows, and multi-machine / central-server setups — seeNEW_MACHINE_SETUP.md.
Full tool reference (30+ tools) lives inAGENTS.md.
Any source (paper · PDF · web · note) │ save_article · new_note ▼ Markdown vault ──► index (DuckDB, or Postgres + pgvector) 00-inbox/ • BM25 + semantic search 10-projects/ • figure OCR + vision descriptions 20-areas/ • auto-wikilinks between related notes 30-resources/ • Ebbinghaus ranking → weekly auto-compression decisions/ memory/ │ ▼ Your AI agent queries it — search_notes · search_figures · get_context
Thevault is the source of truth; the index is rebuildable anytime (sync_index). Filing conventions live in one operating manual —AGENTS.md— served to any agent viaget_agent_instructions(), so every agent files things the same way without being re-taught.
vault/ ├── 00-inbox/ Unprocessed captures ├── 10-projects/ Active projects ├── 20-areas/ Ongoing research / coding domains ├── 30-resources/ Papers & articles (save_article writes here) ├── 40-archive/ Auto-compressed originals ├── decisions/ Architecture Decision Records ├── memory/ goals.md · rules.md (injected every session) └── templates/ Note templates
- AGENTS.md— filing SOP, naming conventions, full tool reference (single source of truth)
- NEW_MACHINE_SETUP.md— source install, self-hosting, multi-machine central server, API keys
- CONTEXT.md— domain model / ubiquitous language
Inspired by biological memory: the Ebbinghaus forgetting curve (access_count / ln(age_days)) for ranking, and sleep-dependent consolidation (weekly LLM compression of low-access notes). Built withMarkItDown·DuckDB·pgvector·FastMCP·Playwright·Claude API.
Local-first MCP memory server with no external dependency, source citations and OKF/Markdown KB.
A local server to query and interact with Markdown knowledge bases by tags, text, slug, or date.
Local-first agent memory: a plain-Markdown Obsidian vault is the source of truth, with a rebuildable DuckDB index for hybrid BM25 + vector + graph recall.
Open-source shared AI memory and team knowledge layer with 44 MCP tools for notes, memories, URLs, emails, projects, graph search, semantic search, and Git sync.
Semantic search and RAG over Apple Notes with on-device embeddings, full CRUD, folder management, and fuzzy title matching. 10 tools. Fully local on macOS.
Local-first second brain for Claude. Saves notes as Markdown and recalls them across sessions with offline semantic search, no cloud and no API keys.
Personal knowledge twin with semantic search. Store voice notes, documents, URLs, principles, and skills from any AI chat, then retrieve them with inline provenance citations. Hosted, multi-tenant, with per-user bearer-token auth and full data isolation.
Local-first MCP server that turns Obsidian and Markdown knowledge bases into an agent-readable graph
MCP server for Obsidian vaults — search, memory, link graph, 23 tools, OAuth-protected.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
