Obsidian MCP Learning System
dhruvs obsidian mcp
ich arbeite diesen sommer daran, ML-Compiler + einige OS-Konzepte zu lernen, also habe ich einen Obsidian-Vault eingerichtet, um meinen Lernfortschritt zu verfolgen
zufälligerweise wollte ich auch mehr Erfahrung mit MCP sammeln, also werde ich einen MCP-Server erstellen, der sich mit Codex verbindet und ihm einige Hinweise gibt, wie er mein Lernen bewerten kann + sicherstellen, dass meine Projekte auf dem richtigen Weg sind
bleibt dran für Updates! wir fangen gerade erst an ☺︎
Roadmap
Dieses Projekt ist ein lokaler MCP-Server, um einen Obsidian-Vault in eine strukturierte Compiler-Lernumgebung zu verwandeln.
Das Ziel ist nicht nur "KI kann meine Notizen lesen." Das Ziel ist der Aufbau eines echten MCP-nativen Lernsystems mit:
Tools für Berechnung und Analyse
Ressourcen für stabile Kontextoberflächen
Prompts für wiederverwendbare Workflows
Related MCP server: research-memory-mcp
Aktueller Status
Phase 1 — Bestehende MCP-Integration
[x] Verbindung von Codex mit einem bestehenden Obsidian MCP-Server
[x] Validierung des grundlegenden Vault-Zugriffs und der Notiz-Zusammenfassung
Phase 2 — Benutzerdefinierter lokaler MCP-Server
[x] Aufbau eines benutzerdefinierten Python MCP-Servers
[x] Bereitstellung erster Tools:
[x]
extract_concepts[x]
get_learning_gaps[x]
generate_study_session[x]
compare_notes_to_project
[x] Registrierung des Servers in Codex
[x] Überprüfung mit dem MCP Inspector
[x] Funktionierende End-to-End lokale Tool-Aufrufe
Als Nächstes
Phase 3 — Ausbau der MCP-Schnittstelle
Ziel: Entwicklung von einer "Ansammlung von Tools" zu einer echten MCP-gestützten Lernoberfläche.
3.1 Ressourcen
Bereitstellung stabiler, inspizierbarer Ansichten des Lernsystems.
Geplante Ressourcen:
[x]
vault://compiler/concepts[x]
vault://compiler/gaps[x]
vault://compiler/recent-notes[x]
vault://project/alignment[x]
vault://weekly-review/latest
Warum:
Tools sind gut für Aktionen
Ressourcen sind gut für persistenten Kontext
Dies lässt den Server eher wie ein System wirken und weniger wie einmalige Funktionen
3.2 Prompts
Hinzufügen wiederverwendbarer Workflow-Vorlagen direkt über MCP.
Geplante Prompts:
[ ]
weekly_learning_review[ ]
generate_study_plan[ ]
notes_vs_project_analysis[ ]
paper_to_implementation_breakdown
Warum:
Entfernt die Notwendigkeit, sich gute Prompt-Formulierungen zu merken
Macht wiederholte Workflows zu erstklassigen Schnittstellen
3.3 Bessere Analyse-Heuristiken
Upgrade von einfachem Keyword-Zählen zu aussagekräftigerer Notiz-Analyse.
Geplante Verbesserungen:
[ ] Frontmatter-bewusste Filterung
[ ] Tag-bewusste Konzeptgruppierung
[ ] Aktualitätsbewusste Analyse
[ ] Notiz-Tiefenbewertung
[ ] Backlinks / Notiz-Link-Graph-Analyse
[ ] Bessere "flach vs. tief"-Erkennung
[ ] Konzept-Clustering statt nur exakter Keyword-Treffer
Warum:
Aktuelle Heuristiken sind nützlich, aber primitiv
Hier verbessert sich die tatsächliche Intelligenz des Servers
Phase 4 — Multi-Quellen-Lernsystem
Ziel: Vergleich und Synthese über mehr als nur Markdown-Notizen hinweg.
Geplante Quellen:
[ ] Obsidian-Vault
[ ] lokales Projekt-Repo(s)
[ ] Papiernotizen / Lesenotizen
[ ] PDFs oder exportierte Zusammenfassungen von Papieren
[ ] Leichtgewichtiger Projekt-Tracker / Task-Datei
Geplante Fähigkeiten:
[ ] Vergleich von Notizen mit der Implementierung
[ ] Vergleich von Papierkonzepten mit Projektlücken
[ ] Erkennung von Themen, die gelernt, aber nicht umgesetzt wurden
[ ] Generierung von Implementierungsideen aus dem kürzlich Gelernten
Warum:
Hier beginnt MCP, wirklich einen hohen Hebel zu bieten
Der Server wird zur Brücke zwischen Lernen, Planen und Bauen
Phase 5 — Codex-Workflow-Integration
Ziel: Den Server einfach und natürlich in täglichen Codex-Workflows nutzbar machen.
Geplante Arbeiten:
[ ] Verbesserung der Tool-Benennung und -Beschreibungen
[ ] Strukturiertere und vorhersehbarere Ausgaben
[ ] Hinzufügen von AGENTS.md-Anleitungen zur Verwendung der einzelnen MCP-Funktionen
[ ] Hinzufügen von Beispiel-Prompts für jedes Tool/Ressource/Prompt
[ ] Reduzierung der Notwendigkeit für manuelle Tool-Aufruf-Formulierungen
Warum:
Ein leistungsstarker MCP-Server ist nutzlos, wenn der Host/Client ihn nicht gut verwendet
Ergonomie ist genauso wichtig wie Fähigkeiten
Zukunft / Stretch-Ideen
Sampling
Potenzielle zukünftige Richtung:
[ ] Dem Server erlauben, modellgenerierte Synthese durch MCP-Sampling anzufordern
Mögliche Anwendungsfälle:
[ ] Automatische Generierung wöchentlicher Reviews
[ ] Synthese von Studienführern aus gruppierten Notizen
[ ] Erstellung von Konzeptzusammenfassungen aus Notiz-Clustern
Hinweis: Dies ist absichtlich keine kurzfristige Priorität. Der Server sollte zuerst über starke Tools/Ressourcen/Prompts verfügen, bevor weiteres agentisches Verhalten hinzugefügt wird.
Remote / gehostete Version
Potenzielle zukünftige Richtung:
[ ] Wechsel von lokalem stdio-Server zu Remote-Server
[ ] Unterstützung von HTTP-Transport
[ ] Hinzufügen von Authentifizierung bei Bedarf
[ ] Unterstützung breiterer Clients über die lokale Codex-Nutzung hinaus
Hinweis: Dies ist Produktisierung, nicht das unmittelbare Lernziel.
Unmittelbare Prioritäten
Priorität 1
Implementierung von Ressourcen:
[x] Konzepte
[x] Lücken
[x] Zusammenfassung aktueller Notizen
[x] Zusammenfassung der Notizen/Projekt-Ausrichtung
Priorität 2
Implementierung von Prompts:
[ ] Wöchentliches Review
[ ] Lernsitzung
[ ] Vergleich Notizen vs. Projekt
Priorität 3
Verbesserung der Heuristiken:
[ ] Frontmatter- und Tag-Unterstützung
[ ] Aktualitätsfilter
[ ] Bessere Tiefenbewertung
Leitprinzip
Dieses Projekt sollte sich in Richtung:
eine echte MCP-Schnittstelle für einen Compiler-Lernworkflow
und weg von:
einem Haufen lose zusammenhängender Notiz-Analysefunktionen
bewegen. Wenn ein neues Feature keines dieser Ziele verbessert, sollte es wahrscheinlich nicht hinzugefügt werden:
Lern-Feedbackschleifen
Studienplanung
Notizen-zu-Projekt-Ausrichtung
Wiederverwendbare Codex-Workflows
Strukturierte MCP-native Schnittstellen
Available Tools
4 toolscompare_notes_to_projectB
Compare note concepts against a local project repo by checking keyword coverage.
Args: vault_path: Absolute path to the Obsidian vault. notes_folder: Folder inside the vault to scan. project_path: Absolute path to the code project to compare against.
Inputs: vault_path, notes_folder, project_path. Returns: result
extract_conceptsB
Extract recurring compiler concepts from notes in a vault folder.
Args: vault_path: Absolute path to the Obsidian vault. folder: Folder inside the vault to scan.
Inputs: folder, vault_path. Returns: result
generate_study_sessionC
Generate a focused study session using recurring concepts and likely gaps.
Args: vault_path: Absolute path to the Obsidian vault. folder: Folder inside the vault to scan. duration_minutes: Target study session length.
Inputs: folder, vault_path, duration_minutes. Returns: result
get_learning_gapsC
Identify likely weak spots based on repeated but shallow concept coverage.
Args: vault_path: Absolute path to the Obsidian vault. folder: Folder inside the vault to scan.
Inputs: folder, vault_path. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct verb and outcome: extracting concepts, identifying gaps, generating a study session, and comparing notes to a project. While the first three operate on vault notes, their purposes and outputs are non-overlapping.
All tool names follow a consistent snake_case verb_noun pattern (extract_concepts, get_learning_gaps, generate_study_session, compare_notes_to_project). The naming is predictable and readable.
Four tools is a well-scoped set for a focused learning assistant, covering the essential operations without bloat. Each tool earns its place in the workflow.
The set covers a full learning loop: extraction, gap analysis, session generation, and project comparison. Minor gaps exist, such as no tool to list vault folders or read/write individual notes, which could help agents orient themselves.
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
An MCP server that gives your AI access to the source code and docs of all public github repos
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that treats Obsidian vaults as knowledge graphs, enabling AI agents to traverse wikilinks, assemble token-budgeted context, and search with backlink awareness.3 npm1MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that provides controlled read/write tools for managing local-first research memory in an Obsidian vault, enabling AI agents to maintain project context across sessions.4 npm1MIT
- AlicenseNot gradedqualityDmaintenanceExtends the official Obsidian MCP server with intelligent learning and second-brain features, including AI-generated challenges, progress analytics, spaced repetition, and knowledge gap analysis.MIT
- AlicenseAqualityBmaintenanceAn MCP server that turns any compatible AI agent into a Zettelkasten partner for creating atomic notes, forming semantic links, detecting clusters, and synthesizing insights from your existing knowledge.1945 PyPI2MIT