Trilium MCP-Server für Gemini CLI

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server, eine spezialisierte Gemini-Skill und einen autonomen Agenten zur Verwaltung von Trilium Notes direkt über Ihr Terminal unter Verwendung der Gemini CLI.

Funktionen

• Vollständige ETAPI-Integration: Erstellen, suchen, verschieben und bearbeiten Sie Notizen mithilfe natürlicher Sprache.

• Autonomer Agent: Ein dedizierter trilium-assistant-Agent für komplexe organisatorische Aufgaben.

• Spezialisierte Skill: Expertenanleitung zur Notizbaumstruktur und zu Attributen von Trilium.

• Sicher: Verwendet eine .env-Datei zum Schutz Ihrer API-Token.

Related MCP server: Notes MCP Server

🛠️ Einrichtung & Installation

1. Voraussetzungen

• Python 3.10+

• Node.js (für Gemini CLI)

• Trilium Notes (mit aktivierter ETAPI)

2. Repository klonen

git clone https://github.com/dhiraj-ydv/trilium-mcp.git
cd trilium-mcp

3. Abhängigkeiten installieren

pip install -r requirements.txt

4. Umgebungsvariablen konfigurieren

Kopieren Sie die Beispiel-Umgebungsdatei und geben Sie Ihre Trilium-Details ein:

cp .env.example .env

Öffnen Sie .env und geben Sie Folgendes an:

• TRILIUM_SERVER_URL: Die URL Ihrer Trilium-Instanz (z. B. http://localhost:8080).

• TRILIUM_ETAPI_TOKEN: Ihr ETAPI-Token (generiert unter Trilium-Einstellungen > Optionen > ETAPI).

🚀 Verwendung mit Gemini CLI

Initialisierung

Führen Sie einfach gemini im Projektverzeichnis aus. Die CLI erkennt automatisch den MCP-Server, den Agenten und die Skill, die im Ordner .gemini/ definiert sind.

Befehle

Verwendung des autonomen Agenten

Der Agent kann mehrstufige Aufgaben bewältigen, wie z. B. das Finden einer Notiz und deren Verschieben:

@trilium-assistant move my 'Drafts' note into the 'Projects' folder.

Verwendung direkter MCP-Tools

Führen Sie gezielte Aktionen direkt aus:

mcp_trilium-mcp_create_note title="Meeting Notes" parentNoteId="root" content="Hello World"

Aktivierung der Skill

Erhalten Sie Expertenrat zur Strukturierung Ihrer Notizen:

activate_skill trilium-notes

📂 Projektstruktur

• server.py: Die Implementierung des MCP-Servers.

• .gemini/settings.json: Konfiguration für die Gemini CLI zum Laden des Servers.

• .gemini/agents/trilium-assistant.md: Die Definition des autonomen Agenten.

• .gemini/skills/trilium-notes/: Spezialisiertes Wissen für Trilium-Workflows.

🛡️ Sicherheit

Dieses Projekt verwendet eine .gitignore, um sicherzustellen, dass Ihre .env-Datei niemals auf GitHub hochgeladen wird. Geben Sie niemals Ihre .env-Datei oder Ihr ETAPI-Token weiter.

📄 Lizenz

MIT