📚 MCP-Hinweise

Ein persönliches Wissensmanagementsystem, das auf dem Model Context Protocol (MCP) basiert und tägliche Notizen in organisiertes, durchsuchbares Wissen umwandelt.

🚀 Verwendung

🛠️ Manuelle Einrichtung

1. Klonen Sie das Repository

   git clone git@github.com:markacianfrani/mcp-notes.git
   cd mcp-notes
   npm i
   npm run build

2. MCP einrichten

🖥️ Claude Desktop

Fügen Sie zu Ihrer claude-desktop-config.json hinzu:

"notes": {
    "command": "node",
    "args": [
        "path/to/this/repo/mcp-notes/dist/index.js",
        "path/to/your/notes"
    ],
},

Related MCP server: Lspace MCP Server

🌟 Projektvision

MCP Notes zielt darauf ab, das Problem der Wissensfragmentierung zu lösen, indem ein System geschaffen wird, in dem tägliche Gedanken, Erfolge und Erkenntnisse:

1. 📥 Schnelle Aufnahme mit minimaler Reibung

2. 🗂️ Automatisch in sinnvolle Strukturen organisiert

3. 🧠 Zu höherem Wissen synthetisiert

4. 🔍 Bei Bedarf einfach abzurufen

Das Ziel besteht darin, eine externe Gummiente zu bauen, die Ihren Arbeitsspeicher in Echtzeit von jedem Tool aus auslesen und den Müll aussortieren kann.

🧩 Kernkonzepte

1. 📅 Tägliche Protokolle

Tagesprotokolle bilden die atomare Erfassungseinheit in MCP Notes. Jeder Tag erhält eine eigene Markdown-Datei, in der Sie Beobachtungen des Tages festhalten können. Stellen Sie sich Tagesprotokolle wie ein laufendes Hauptbuch vor.

💡 TIPP: Nutzen Sie die Schnelleingabe-Tastenkombination von Claude Desktop

MCP ist Tool-agnostisch, sodass Sie über Konversationen, aber auch Tools hinweg /loggen können – bitten Sie Copilot oder Cursor, nach der Behebung eines Fehlers eine Zusammenfassung der gewonnenen Erkenntnisse zu protokollieren, oder lassen Sie Claude Desktop einen neuen Ansatz für ein altes Problem speichern.

2. 📊 Rollups

Rollups sind automatisch generierte Zusammenfassungen, die tägliche Protokolle zu übergeordneten Erkenntnissen und Mustern verdichten. Sie helfen dabei, einzelne Informationen zu einem schlüssigen Bericht Ihrer Arbeit und Ihres Denkens zu verknüpfen.

3. 📚 Wissenskategorien

Alle Notizen im System fallen in eine von vier Kategorien:

• 🏆 Leistung : Probleme lösen, Funktionen vervollständigen, Fehler beheben

• 💡 Einblick : Muster, architektonische Entscheidungen, bessere Arbeitsweisen

• 📝 TODO : Aufgaben im Zusammenhang mit größeren Zielen, sinnvolle Verbesserungen

• 📖 Wissen : Technische Details, Kontext, Gründe, Techniken

🎨 Designprinzipien

MCP Notes basiert auf mehreren zentralen Designprinzipien:

1. 📄 Klartext zuerst

Alle Notizen werden als reine Text-Markdown-Dateien gespeichert, um Folgendes sicherzustellen:

• Zukunftssicherer Speicher, der nicht an proprietäre Formate gebunden ist

• Versionskontrollkompatibilität

• Einfache Bearbeitung mit jedem Texteditor

• Transparente Datenstruktur

2. ✍️ Reibungsarme Erfassung

Die primäre Schnittstelle ist darauf ausgelegt, den Aufwand bei der Aufzeichnung von Gedanken zu minimieren:

• Einfache Texteingabe

• Automatische Kategorisierungshilfe

• Zum Zeitpunkt der Erfassung ist keine komplexe Organisation erforderlich

3. 🔄 Fortschrittliche Organisation

Anstatt von vornherein eine starre Organisation zu verlangen, verfolgt MCP Notes einen progressiven Ansatz:

• Erfassen Sie unverfälschte Gedanken und Aktivitäten

• Inhalte automatisch kategorisieren

• Generieren Sie regelmäßige Zusammenfassungen

• Verknüpfen Sie verwandte Elemente im Laufe der Zeit

4. 🤖 KI-Erweiterung

Das System nutzt KI, um das menschliche Denken zu verbessern, nicht um es zu ersetzen:

• Helfen Sie dabei, Informationen zu kategorisieren

• Zusammenfassungen und Verbindungen generieren

• Relevante Notizen aus der Vergangenheit ans Licht bringen

• Erkennen von Mustern im Zeitverlauf

🧰 Verfügbare Tools

MCP Notes bietet eine Reihe von Tools, die über Claude Desktop oder andere MCP-kompatible Clients aufgerufen werden können. Mit diesen Tools können Sie Ihre Notizen erfassen, organisieren und abrufen.

📝 Kernnotiz-Tools

/log

Erstellt oder aktualisiert die heutige Tagesprotokolldatei mit Ihren Notizen.

Aufrufen mit: „Protokolliere dies in meinem täglichen Protokoll: …“, „Füge eine Zusammenfassung davon meinem Protokoll hinzu: …“

/rollup

Fasst tägliche Notizen zu einer geordneten Zusammenfassung mit Kategorien, Verbindungen und Aktionspunkten zusammen.

Aufruf mit: „Meine Notizen für heute zusammenfassen“

write_note

Erstellt eine neue Notiz oder überschreibt eine vorhandene Notiz mit Inhalt.

sticky

Bewertet die „Klebrigkeit“ eines Gedankens basierend auf Umsetzbarkeit, Langlebigkeit, Auffindbarkeit und zukünftigem Referenzwert.

Rufen Sie auf mit: „Ist diese Idee einprägsam?“

evaluateInsight

Bewertet den langfristigen Wert und die Bedeutung einer Erkenntnis oder eines Gedankens.

Fragen Sie: „Ist diese Erkenntnis langfristig wertvoll?“

📂 Dateisystem-Tools

search_files

Sucht rekursiv nach Dateien und Verzeichnissen, die einem Muster in Ihrem Notizenverzeichnis entsprechen.

read_note

Liest den kompletten Inhalt einer Notizdatei aus Ihrem Notizenverzeichnis.

read_multiple_notes

Liest den Inhalt mehrerer Notizdateien gleichzeitig.

list_directory

Listet den Inhalt eines Verzeichnisses in Ihren Notizen auf.

create_directory

Erstellt ein neues Verzeichnis in Ihren Notizen.

Informationen zum Versionsverlauf und zu Änderungen finden Sie in der Datei CHANGELOG.md .

💡 Verfügbare Eingabeaufforderungen

Ist das atomar?

Zerlegt Ideen in ihre einfachsten Einzelteile. Nutzen Sie diese Eingabeaufforderung, um umfangreiche Ideen in kleinere Konzepte umzuwandeln. Kleinere Notizen lassen sich viel einfacher mit anderen Notizen verknüpfen.