MCP-Server von TriliumNext Notes

⚠️ HAFTUNGSAUSSCHLUSS: Dies ist ein Prototyp für https://github.com/TriliumNext/Notes/issues/705 . Nur für Entwickler empfohlen. Bitte sichern Sie Ihre Trilium-Notizen, bevor Sie dieses Tool verwenden. ⚠️

Ein Model Context Protocol-Server für TriliumNext Notes. Dieser Server bietet Tools für die Interaktion mit Ihrer Trilium Notes-Instanz über MCP.

Update: Unterstützt die neueste Version von TriliumNext v0.92.6

Hinweis: Wir empfehlen die Verwendung mit der Cline-Erweiterung in VSCode anstelle von Claude Desktop

Schnellstart

Stellen Sie sicher, dass Sie zuerst Ihre Umgebungsvariablen einrichten:

• TRILIUM_API_URL (Standard: http://localhost:8080/etapi )

• TRILIUM_API_TOKEN (erforderlich, erhalten Sie dies aus Ihren Trilium Notes-Einstellungen)

Related MCP server: MCP TriliumNext

Installation

1. Verwendung mit Claude Desktop

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

Fügen Sie dem mcpServers -Objekt in Ihrer Claude-Konfigurationsdatei die folgende Konfiguration hinzu:

Für die lokale Installation (unter Windows)

"triliumnext-mcp": {
  "command": "cmd",
  "args": [
        "/k",
        "npx",
        "-y",
        "triliumnext-mcp"
      ],
   "env": {
    "TRILIUM_API_URL": "http://localhost:8080/etapi",
    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>"
  }
}

Für die lokale Installation (unter Linux)

"triliumnext-mcp": {
  "command": "npx",
  "args": [
        "-y",
        "triliumnext-mcp"
      ],
   "env": {
    "TRILIUM_API_URL": "http://localhost:8080/etapi",
    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>"
  }
}

Für die Entwicklung (unter Windows/Linux)

cd /path/to/triliumnext-mcp
npm run build

"triliumnext-mcp": {
  "command": "node",
  "args": [
        "/path/to/triliumnext-mcp/build/index.js"
  ],
  "env": {
    "TRILIUM_API_URL": "http://localhost:8080/etapi",
    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>"
  }
}

Speicherort der Konfigurationsdatei:

• Windows: %APPDATA%/Claude/claude_desktop_config.json

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Verfügbare Tools

Der Server stellt die folgenden Tools zur Notizverwaltung bereit:

• search_notes - Notizen durchsuchen

  • Erfordert: Suchanfrage

  • Optional: fastSearch (Volltextsuche umschalten), includeArchivedNotes

• get_note - Ruft den Inhalt einer Notiz nach ID ab

  • Erfordert: Notiz-ID

• create_note - Erstelle eine neue Notiz

  • Erfordert: ID der übergeordneten Notiz, Titel, Typ, Inhalt

  • Optional: MIME-Typ für Code-/Datei-/Bildnotizen

  • Unterstützte Notiztypen: Text, Code, Datei, Bild, Suche, Buch, RelationMap, Render

• update_note - Eine vorhandene Notiz aktualisieren

  • Erfordert: Notiz-ID

  • Optional: neuer Titel, neuer Inhalt

• delete_note - Eine Notiz löschen

  • Erfordert: Notiz-ID

Entwicklung

Wenn Sie zum Server beitragen oder ihn ändern möchten:

# Clone the repository
git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch