Logseq MCP Tools

Logseq MCP-Tools

Dieses Projekt bietet eine Reihe von Model Context Protocol (MCP)-Tools, die es KI-Agenten ermöglichen, mit Ihrer lokalen Logseq-Instanz zu interagieren.

Installation

1. Stellen Sie sicher, dass Sie Python 3.11+ installiert haben
2. Dieses Repository klonen
3. Installieren Sie Abhängigkeiten:
   pip install -e .

Aufstellen

1. Stellen Sie sicher, dass in Ihrem Logseq die API aktiviert ist.
   • Gehen Sie in Logseq zu Einstellungen > Erweitert > Entwicklermodus > Entwicklermodus aktivieren
   • Gehen Sie dann zu Plugins > Logseq Developer Plugin aktivieren
   • Legen Sie außerdem in den erweiterten Einstellungen ein API-Token fest
   • Starten Sie Logseq neu
2. Konfigurieren Sie den MCP-Server in Ihrer Cursor-MCP-Konfigurationsdatei (normalerweise unter ~/.cursor/mcp.json ):
   { "mcpServers": { "logseq": { "command": "/opt/homebrew/bin/uvx", "args": ["logseq-mcp"], "env": { "LOGSEQ_API_URL": "http://localhost:12315", "LOGSEQ_TOKEN": "your-token-here" } } } }

ODER

3. Konfigurieren Sie Claude Code für die Verwendung des MCP-Servers mit:

• Umfang auswählen
• Wählen Sie Stdio
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

Verwendung mit Cursor und Claude

Hinzufügen zu den MCP-Tools von Cursor

1. Konfigurieren Sie den MCP-Server wie oben im Abschnitt „Setup“ gezeigt
2. Öffnen Sie den Cursor und gehen Sie zum MCP-Bedienfeld (Seitenleiste).
3. Das Logseq-Tool sollte in Ihrer Liste der verfügbaren Tools erscheinen

Verwendung mit Claude

Wenn Sie Claude in Cursor verwenden, müssen Sie ihm mit einer Eingabeaufforderung ähnlich der folgenden mitteilen, dass Ihnen Logseq-Tools zur Verfügung stehen:

„Sie haben Zugriff auf Logseq-Tools, die Ihnen bei der Interaktion mit meinem Logseq-Diagramm helfen können. Sie können Funktionen wie logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name) usw. verwenden.“

Verfügbare Tools

Alle Tools sind unter dem logseq -Namespace verfügbar:

Seiten

• logseq.get_all_pages : Ruft eine Liste aller Seiten im Logseq-Diagramm ab
• logseq.get_page : Ruft eine bestimmte Seite nach Namen ab
• logseq.create_page : Eine neue Seite erstellen
• logseq.delete_page : Löscht eine Seite und alle ihre Blöcke

Blöcke

• logseq.get_page_blocks : Alle Blöcke von einer bestimmten Seite abrufen
• logseq.get_block : Holen Sie sich einen bestimmten Block nach ID
• logseq.create_block : Einen neuen Block auf einer Seite erstellen
• logseq.insert_block : Fügt einen Block als untergeordnetes Element eines anderen Blocks ein.
• logseq.update_block : Aktualisieren Sie einen vorhandenen Block
• logseq.move_block : Verschiebt einen Block an einen anderen Ort
• logseq.remove_block : Entfernt einen Block und alle seine untergeordneten Elemente
• logseq.search_blocks : Suche nach Blöcken, die einer Abfrage entsprechen

Arbeiten mit Logseq

Journalseiten

Journalseiten in Logseq haben ein bestimmtes Format und bestimmte Attribute:

1. Verwenden Sie beim Erstellen oder Zugreifen auf Journalseiten das Format „mmm dth, yyyy“ (z. B. „4. April 2025“)
2. Journalseiten werden von Logseq automatisch mit der richtigen Datierung formatiert
3. Journalseiten haben spezielle Attribute, die automatisch von Logseq festgelegt werden:
   • journal? : true - Zeigt an, dass dies eine Journalseite ist
   • journalDay : JJJJMMTT – Das Datum im numerischen Format (z. B. 20250404 für den 4. April 2025)
4. Beispiel: await logseq.create_page("Apr 4th, 2025")

Wichtig: Sie müssen die Attribute „ journal? oder journalDay nicht manuell festlegen. Wenn Sie eine Seite mit dem richtigen Datumsformat (z. B. „4. April 2025“) erstellen, wird sie automatisch als Journalseite mit den entsprechenden Attributen konfiguriert.

Blockstruktur und Formatierung

Blöcke in Logseq haben einige wichtige Eigenschaften, die man verstehen muss:

1. Automatische Aufzählungszeichen : Alle Blöcke werden in der Logseq-Benutzeroberfläche automatisch als Aufzählungszeichen dargestellt
2. Seitenlinks : Erstellen Sie Links mit doppelten Klammern: [[Page Name]]
3. Hierarchische Blöcke :
   • Blockstrukturdaten enthalten hierarchische Informationen:
     • parent : Die ID des übergeordneten Blocks
     • level : Die Einrückungsebene (1 für oberste Ebene, 2+ für eingerückte Blöcke)
     • left : Der Block links (normalerweise der übergeordnete Block bei eingerückten Blöcken)
4. Blockinhalt : Beim Erstellen von Blöcken können Sie Textformatierungen einschließen:
   • Grundlegendes Markdown wird unterstützt (fett, kursiv usw.)
   • Aufzählungspunkte innerhalb eines Blocks werden möglicherweise nur eingeschränkt unterstützt
   • Mehrzeiliger Inhalt wird unterstützt, unterliegt aber möglicherweise den Parsing-Regeln von Logseq
5. Journalblöcke : Auf Journalseiten erstellte Blöcke erben besondere Attribute:
   • journal? wahr
   • journalDay : JJJJMMTT – Dasselbe wie die Journalseite

Hinweis: Wie bei Journalseiten werden diese Blockattribute automatisch von Logseq verwaltet. Sie müssen die Attribute journal? oder journalDay beim Erstellen von Blöcken auf Journalseiten nicht manuell festlegen.

Anwendungsbeispiele für allgemeine Aufgaben

Arbeiten mit dem Cursor-Agenten: Wenn Sie Logseq MCP-Tools in Cursor konfiguriert haben, können Sie dem Agenten Eingabeaufforderungen wie die folgenden geben:

• „Erstellen Sie eine neue Seite mit dem Namen ‚Besprechungsnotizen‘ mit Aufzählungspunkten für die heutige Tagesordnung.“
• „Fügen Sie die heutigen Aufgaben meiner Tagebuchseite mit einem Abschnitt ‚Aufgaben‘ hinzu.“
• „Aktualisieren Sie den heutigen Journaleintrag mit [[Projektplan]] und setzen Sie sein untergeordnetes Element auf ‚Meilenstein 1 abgeschlossen‘.“
• „Durchsuchen Sie mein Diagramm nach Blöcken zum Thema ‚Python-Projekte‘ und organisieren Sie sie auf einer neuen Seite.“

Der Agent verwendet die entsprechenden Logseq-Tools, um diese Vorgänge an Ihrem Diagramm durchzuführen.