Second Brain
Portable memory for AI agents: an Obsidian vault served over MCP, on npm and the official MCP Registry, rated A on Glama.
Second Brain(09.2026 – Present)
brain-mcp · v0.5.2 · MIT
Portable memory for your agents.
A personal superintelligence built from the notes you already keep: one Obsidian vault, served over MCP from your own machine to every AI you use.
Memory for Hermes Agent
Which database does Harbor Ledger use, and how do I restore it?
- hubHarbor Ledger0.98
- runbookRestore the ledger database0.97
- noteHome server facts0.92
- conceptPostgreSQL0.90
coverage: good · example vault
drag to turn · hover a note
Insights(02.10 – 17.10)
- npm downloads
668668 since 08.10- Git clones
425425 161 unique in 14 days- Right note first
8383 %vs 42% keyword only- MCP tools
1414 8 read · 6 write
| Date | Git clones | Unique cloners |
|---|---|---|
| 02.10.2026 | 0 | 0 |
| 03.10.2026 | 0 | 0 |
| 04.10.2026 | 118 | 53 |
| 05.10.2026 | 15 | 11 |
| 06.10.2026 | 10 | 6 |
| 07.10.2026 | 4 | 4 |
| 08.10.2026 | 142 | 27 |
| 09.10.2026 | 55 | 30 |
| 10.10.2026 | 16 | 10 |
| 11.10.2026 | 7 | 5 |
| 12.10.2026 | 3 | 3 |
| 13.10.2026 | 8 | 5 |
| 14.10.2026 | 1 | 1 |
| 15.10.2026 | 15 | 8 |
| 16.10.2026 | 21 | 6 |
| 17.10.2026 | 10 | 8 |
One command sets it up (Node 22 or newer): it lists the Obsidian vaults on your machine and asks which to serve, offers the local smart-search models, and offers to connect Claude Code. Or connect a client by hand:
hermes mcp add brain --command npx --args -y debawho-brain-mcp --stdioVerified(4)
History(45 commits)
- 1004.10
- 05.10
- 106.10
- 07.10
- 1408.10
- 09.10
- 10.10
- 11.10
- 12.10
- 13.10
- 14.10
- 15.10
- 516.10
- 317.10
- 1218.10
- Merged
- Merged
0.5.2: queue rankings, two at a time
#20 · 18.10.2026
- Merged
0.5.1: hub and topic pages in graph slots, shared-link boost
#19 · 18.10.2026
- Merged
- Merged
Facts that change over time (#8), plus two ranking fixes
#17 · 16.10.2026
- Merged
- Merged
0.4.0: a 50 MB install, with smart search as an opt-in add-on
#15 · 08.10.2026
- Merged
- Merged
- Merged
README: Hermes Agent setup; VS Code off the mcpServers line
#12 · 08.10.2026
- Merged
- Merged
feat: Dockerfile and docker-compose for self-hosting
#9 · 06.10.2026
What I built
- Open-source MCP server that turns an Obsidian vault into live, private context for Claude and any MCP client: who you are, what you are working on, and tools to search, follow links and write back.
- Graph-aware hybrid retrieval that never leaves the machine — section BM25 and bge-small embeddings fused with RRF, a walk from the best notes along their strongest links, a cross-encoder reranker, and a floor that answers "nothing relevant" instead of guessing.
- Public over OAuth 2.1 behind Cloudflare Tunnel, with read, write and private scopes, credential redaction and an audit line for every call. Any ranking change has to beat the bundled evals first.
- TypeScript
- MCP
- SQLite FTS5
- Embeddings
- OAuth 2.1
Downloads from the npm registry, clones from GitHub repository traffic (owner only, kept 14 days, stored here as it rolls).
Retrieval figures from eval-retrieval.mjs on the example vault, in the brain-mcp README.
The 3D brain pins every note of an illustrative everyday vault (the same as on 2brain.debawho.xyz) to the cortex; orange arcs are its wikilinks.
Live figures as of 18.10.2026.
Next project
SECOR
Local security checks for what you build with AI, and a guard on every MCP tool call your agent makes.