lightrag-mcp

MCP-Server, der LightRAG mit jedem MCP-Client verbindet – Cursor, Claude Desktop und anderen. Gibt dem Agenten Zugriff auf eine dauerhafte Wissensbasis: Notizen, Entscheidungen, Dokumentationen, Runbooks.

Zwei Werkzeuge, weil es bei der Wissensextraktion zwei verschiedene Szenarien gibt:

Beide Werkzeuge sind als readOnlyHint markiert, daher wird der Client sie nicht als zustandsverändernd betrachten.

Installation

npm install

Erforderlich ist Node.js 18 oder neuer – es wird der eingebaute fetch verwendet.

Related MCP server: knowlib

Konfiguration

Erstellen Sie eine .env neben package.json:

LIGHTRAG_URL=http://localhost:9621
LIGHTRAG_API_KEY=ваш-ключ

LIGHTRAG_URL ist optional und standardmäßig http://localhost:9621. LIGHTRAG_API_KEY ist erforderlich: Ohne ihn stürzt der Server beim Start mit einer klaren Fehlermeldung ab, nicht erst beim ersten Request.

Der Pfad zur Umgebungsdatei kann mit der Variable LIGHTRAG_MCP_ENV_FILE überschrieben werden – praktisch, wenn der Client den Server aus einem anderen Arbeitsverzeichnis startet.

Verbindung zu Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lightrag": {
      "command": "node",
      "args": ["/абсолютный/путь/lightrag-mcp/src/server.js"],
      "env": {
        "LIGHTRAG_MCP_ENV_FILE": "/абсолютный/путь/lightrag-mcp/.env"
      }
    }
  }
}

Suchmodi

Der Parameter mode akzeptiert mix (Standard), hybrid, local, global und naive. Ein unbekannter Modus wird vor der Netzwerkanfrage abgelehnt. Anfragen werden immer mit aktivierten Quellenlinks und Re-Ranking gesendet.

Tests

npm test

Die Tests verwenden das eingebaute node --test, ohne externe Abhängigkeiten. HTTP wird über den Parameter fetchImpl ersetzt, daher werden sowohl erfolgreiche Antworten als auch Fehler geprüft: fehlender Schlüssel, leere Frage, unbekannter Modus, erfolgloser Antwortstatus.

Lizenz

MIT