Second Brain MCP Server

Ein schreibgeschützter MCP-Server für den intelligenten, sicheren Zugriff auf Ihren Obsidian-Vault – ermöglicht semantische Suche, Metadaten-Filterung und mehr für LLMs.

Funktionen

• Effiziente Datenbankspeicherung: SQLite-basierte Indizierung für große Vaults mit persistentem Caching

• Speichermodus-Option: Optionale In-Memory-Indizierung für kleine Vaults oder zur Entwicklung

• Semantische Suche: Volltextsuche über alle Notizen mit Fuzzy-Matching

• Tag-basierte Filterung: Suche nach hierarchischen Tags (z. B. work/puppet, tech/golang)

• Pfad-basierte Filterung: Filtern nach Verzeichnismustern (z. B. Work/Puppet/**)

• Zeitliche Abfragen: Filtern von Notizen nach Erstellungs-/Änderungsdatum

• Metadaten-Filterung: Filtern nach Typ, Status und Kategorie

• Notizabruf: Abrufen des vollständigen Inhalts spezifischer Notizen

• Intelligente Zusammenfassung: Erstellen von Zusammenfassungen von Notizsammlungen

• Kürzliche Notizen: Schneller Zugriff auf kürzlich geänderte Notizen

• Archiv-Kontrolle: Optionale Einbeziehung archivierter Notizen in die Suche

• Wissenslücken: Erkennung verwaister Wikilinks und offener Fragen im gesamten Vault

• Spaced Review: Anzeige veralteter Notizen, sortiert nach Link-Wichtigkeit für regelmäßige Überprüfungen

• Verwandte Notizen: Score-basierte Entdeckung verwandter Notizen über geteilte Links, Tags und Titelüberschneidungen

• Vault-Graph: Vollständiger Link-Graph mit Hub-Erkennung, Statistiken zu defekten Links und Analyse verwaister Notizen

• Sicherheit: Schutz vor Pfad-Traversal, Dateigrößenbeschränkungen, Eingabevalidierung

Vault-Kompatibilität

Dieser Server funktioniert mit jedem Verzeichnis von Markdown-Dateien – nicht nur mit Obsidian-Vaults. Er arbeitet rein auf Dateisystemebene und hat keine Abhängigkeit von der Obsidian-App.

Verwendung mit Foam

Setzen Sie --vault-path auf Ihr Foam-Arbeitsbereichs-Stammverzeichnis. Es sind keine Konfigurationsänderungen erforderlich:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

Foam-Funktionen, die sofort funktionieren:

• [[wikilinks]] und [[target|aliased links]] werden in Graph-Tools aufgelöst

• YAML-Frontmatter-Tags (sowohl Inline [tag1, tag2] als auch Block-Listen-Stil)

• Verschachtelte Tag-Hierarchien (work/backend)

• Unterordner-Struktur (notes/, journal/, projects/)

• Notizen ohne Frontmatter werden mit sicheren Standardwerten indiziert

Der .vscode/-Ordner wird automatisch von der Indizierung ausgeschlossen.

Schreibgeschütztes Design

Dieser MCP-Server ist absichtlich schreibgeschützt, um sicherzustellen, dass Ihr Vault während KI-Interaktionen sicher bleibt. Er bietet:

• ✅ Suchen und Abrufen von Notizen

• ✅ Filtern nach Metadaten und Pfaden

• ✅ Erstellen von Zusammenfassungen und Statistiken

• ❌ Kein Erstellen oder Bearbeiten von Notizen

• ❌ Keine Dateimodifikationen

Für Schreibvorgänge sollten Sie dedizierte Obsidian-Plugins mit integrierten Sicherheitsprüfungen in Betracht ziehen.

Installation

Konfiguration & Installation

Ein-Klick-Installation

• VS Code:

• VS Code Insiders:

• Cursor:

Manuelle Installation

Keine Installation erforderlich! Direkt mit npx verwenden:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Lokale Entwicklung

cd second-brain-mcp
npm install
npm run build
npm link

Dies macht den Server global als second-brain-mcp verfügbar.

Claude Code & Claude Desktop

Claude Code

Fügen Sie den Server hinzu mit:

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

Siehe docs/configuration.md für Vault-Struktur, CLI-Argumente und Konfigurationsbeispiele.

Siehe docs/api.md für die vollständige MCP-API-Referenz und Anwendungsbeispiele.

Verwendung mit Claude Code

Fügen Sie dies zu Ihrer MCP-Konfigurationsdatei hinzu.

Konfiguration für einen einzelnen Vault

macOS/Linux: Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json Windows: Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

Konfiguration für mehrere Vaults

Sie können mehrere Vault-Instanzen konfigurieren:

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

Lokale Entwicklungseinrichtung

Wenn Sie lokal mit npm link entwickeln:

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

Siehe docs/examples.md für weitere Beispielabfragen.

Dokumentation

Siehe docs/README.md für:

• API-Referenz

• Konfiguration & CLI-Optionen

• Beispielabfragen

• Entwicklungs- & Speicherarchitektur

• Mitwirken

• Abhängigkeiten

• Architektur & Datenbankschema

• Sicherheit & Suche

• Beispielabfragen

• Entwicklung

• Mitwirken

• Abhängigkeiten

• Lizenz

Schnellstart

Starten Sie den Server sofort mit npx (keine Installation erforderlich):

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Oder fügen Sie ihn zu Claude Code/Claude Desktop hinzu (siehe Konfiguration & Installation unten).

Fehlerbehebung & FAQ

Siehe docs/configuration.md für häufige Probleme und Lösungen.

Siehe docs/search.md für Details zu Suchgewichtungen und Scoring.

Siehe docs/security.md für Details zu Sicherheitsfunktionen und Schutzmaßnahmen.

Siehe docs/development.md für den Entwicklungs-Workflow und Speicherdetails.

Siehe docs/contributing.md für Richtlinien zur Mitarbeit.

Speicherarchitektur

Der Server verwendet standardmäßig SQLite-Datenbankspeicherung für effiziente Indizierung und persistentes Caching:

• Datenbankmodus (Standard): Speichert indizierte Notizen in .second-brain-mcp/notes.db innerhalb Ihres Vaults

  • Persistente Indizierung (überlebt Server-Neustarts)

  • Effizient für große Vaults (1000+ Notizen)

  • Volltextsuche mit SQLite FTS5

  • Geringerer Speicherverbrauch

• Speichermodus (Optional): Verwenden Sie das --use-memory Flag für In-Memory-Speicherung

  • Schneller für kleine Vaults (<100 Notizen)

  • Kein Festplatten-I/O-Overhead

  • Nützlich für Entwicklung und Tests

  • Verwendet Fuse.js für Fuzzy-Suche

Siehe docs/architecture.md für das Architekturdiagramm. Siehe docs/database-schema.md für das Datenbankschema.

Architektur

• src/index.ts: MCP-Server-Implementierung mit Tool-Handlern

• src/vault.ts: Orchestrierung der Vault-Indizierung und Sicherheitskontrollen

• src/storage.ts: Abstraktion der Speicherschnittstelle

• src/database-storage.ts: SQLite-basierte Speicherimplementierung

• src/memory-storage.ts: In-Memory-Speicherimplementierung mit Fuse.js

• src/storage-factory.ts: Speicher-Factory-Muster für die Modusauswahl

• src/config.ts: Konfigurationsmanagement mit Standardwerten

• src/types.ts: TypeScript-Typdefinitionen und Validierungs-Utilities

• src/__tests__/: Unit-Tests für kritische Funktionen

Siehe docs/dependencies.md für eine vollständige Liste der Produktions- und Entwicklungsabhängigkeiten.

Support

Wenn second-brain-mcp Ihnen Zeit spart, ziehen Sie in Betracht, mich auf GitHub zu sponsern oder mir einen Kaffee auszugeben.

Lizenz

MIT