MCP.Market

second-brain MCP server

by ddmanyes·io.github.ddmanyes/mcp-second-brain·v0.1.0·6 stars
No reviews yet

Self-maintaining knowledge vault: figure-level search, auto-wikilinks, and memory compression.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

6 stars19 downloads/wk

Reviews

Write one

Nobody has reviewed second-brain MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

second-brain MCP tools (19, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • consolidate_tool

    Find and consolidate clusters of semantically similar notes.

  • extract_figures_for

    Manually trigger figure extraction for a saved article.

  • extract_rules_tool

    Extract L3 declarative rules from high-access notes into memory/rules.md.

  • get_context

    Load session context: current goals + top-20 most recently active notes. Call this at the start of every session to orient yourself.

  • get_decisions

    Get decision records from the vault.

  • index_stats

    Show vault index statistics: total notes, breakdown by type, DB location.

  • new_notewrite action

    Create a new note in the vault using the correct folder and template.

  • prune_archive_toolwrite action

    Delete archived originals older than min_age_days that have a snapshot.

  • read_note

    Read a specific note by its relative path within the vault.

  • read_note_as_image

    Read a note as a PNG snapshot (direct image for VLM agents) or text fallback.

  • save_article

    Convert a web article or PDF into a markdown note and save it to 30-resources/.

  • search_figures

    Search figures by OCR text or semantic description across all saved articles.

  • search_notes

    Hybrid semantic + full-text search across all vault notes.

  • sleep_status

    Check current sleep triggers and list candidates without compressing.

  • snapshot_note_tool

    Render a markdown note to PNG snapshot for token-efficient storage.

  • sync_index

    Rebuild the DuckDB index by scanning all vault markdown files. Run this after adding notes manually, or when setting up on a new machine.

  • update_goalswrite action

    Replace the contents of memory/goals.md with new content.

  • update_links_toolwrite action

    Refresh auto-generated related wikilinks in one note or all notes.

  • vault_sleep

    Compress old low-activity notes to slim down the vault.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan10 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How second-brain MCP compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 90% of 3,470 Web search servers
Tools
19
the typical Web search server has 5
Tools that change things
21%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
6
more than 81% of 1,786 Web search servers
Downloads a week
19
more than 6% of 827 Web search servers with a package

What its tools let an agent do: 13 read · 2 create · 4 change

Install second-brain MCP in Claude Code, Cursor or VS Code

claude mcp add mcp-second-brain -- uvx mcp-second-brain
Add to Cursor

What the publisher says

From the second-brain MCP repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.ddmanyes/mcp-second-brain -->

second-brain MCP Server

A self-maintaining personal knowledge base for AI agents — a plain-Markdown vault, powered by MCP.

📖 English · 繁體中文

A local knowledge base your AI agent can read, write, and maintain 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.

Highlights

  • One command saves anything — savearticle(urlor_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).
  • Read-only housekeeping audit — inspect article metadata, links, exact duplicate candidates, inbox age, and source freshness without changing the vault.
  • 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.

Quick Start (Claude Code)

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 agent init_vault to verify.

⚠️ PyPI currently lags the source tree. For the newest build — plus Claude Desktop, Windows, and multi-machine / central-server setups — see NEWMACHINESETUP.md.

Core Tools

Full tool reference (46 tools) lives in AGENTS.md.

Use searchnotes when you need content, healthcheck when the server or index may be unhealthy, and auditarticlerecords when you need a housekeeping report. Audit results never merge, archive, or delete notes automatically.

How It Works

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

second-brain MCP: common questions

Is second-brain MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the second-brain MCP safety report
How do I install second-brain MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does second-brain MCP need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is second-brain MCP maintained?
The last commit was 53 days ago (2026-09-12). The latest release is v0.1.0.
What can I use instead of second-brain MCP?
Servers from other publishers that do the same job: DocsMint MCP server, Shodh Memory MCP server and Reverie MCP server. Compare all second-brain MCP alternatives.
How does second-brain MCP compare with other Web search MCP servers?
safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 19 (the typical Web search server has 5); tools that change things 21% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to second-brain MCP

Same job from other publishers: the closest match first, then the best rated.

All second-brain MCP alternatives →
  • DocsMint
    Cloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.
    A
  • Shodh Memory
    Cognitive memory for AI agents — semantic search, Hebbian learning, knowledge graphs.
    C
  • Reverie
    Graph memory that dreams: Neo4j knowledge-graph memory for AI agents with hybrid search
    B
  • Octobrain
    Persistent memory for AI assistants with semantic search and knowledge graph relationships.
    More from Muvon →
    A
  • obsei
    Self-hosted customer feedback with PII stripped at ingest: search, stats and themes with citations.
    A