knowmind
Knowledge graph & long-term memory for AI agents: recall, relations, store, stats, health.
Open source Open in the app JSON README (API)
About
Knowledge graph & long-term memory for AI agents: recall, relations, store, stats, health.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- whosoeverm8
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.14
- Last push
- 2026-08-10T20:50:41Z
- Repository state
- ativo
- Language
- JavaScript
- License
- Apache-2.0
- Added
- 2026-08-29 03:02:20
- Updated
- 2026-08-29 03:02:20
- Origin id
io.github.WhoSoEverM8/knowmind
README
# knowmind
**Ihr KI-Assistent kennt Ihr Unternehmen nicht.** Er beginnt jedes Gespräch bei null, und Sie
erklären ihm zum wiederholten Mal dieselben Zusammenhänge. knowmind ist das Gedächtnis darunter:
Was Sie einmal ablegen, steht in Claude, ChatGPT, Cursor und Ihren eigenen Anwendungen zur
Verfügung. Betrieben in Deutschland, im Rechenzentrum Nürnberg.
**Der Privat-Tarif kostet dauerhaft nichts und verlangt keine Zahlungsdaten.** Schnittstelle,
Kommandozeile und MCP-Server sind in jedem Tarif enthalten, auch dort.
<!-- mcp-name: io.github.Schubeler-Consulting/knowmind -->
[](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de) · [Discord](https://discord.gg/nRguXx5hDQ) · dieses Paket unter Apache-2.0
## Installation
```
npm install -g knowmind
```
Oder ohne Installation direkt als MCP-Server: `npx -y knowmind mcp`
## Einrichtung
1. Kostenloses Konto auf [knowmind.de](https://knowmind.de) anlegen und dort einen Zugangsschlüssel
erzeugen: Dashboard → API-Tokens
2. Lokal speichern:
```
knowmind login --token kmt_xxxxxxxx
```
Alternativ über ENV:
```
export KNOWMIND_TOKEN=kmt_xxxxxxxx
export KNOWMIND_API_URL=https://knowmind.de
```
## Befehle
```
npx -y knowmind install <ide> MCP-Server im KI-Client verdrahten (claude, cursor, vscode …)
knowmind init Automatische Gedächtnis-Pflege im KI-Client einrichten
knowmind search "Wo läuft die OKR-App?"
knowmind upload notizen.md --title "Meeting Notizen 2026-05-12"
knowmind stats
knowmind health
knowmind status Lebenszeichen des Gedächtnisses (Report)
knowmind status --line Einzeilige Statusline für Ihr KI-Werkzeug
knowmind config
```
Die Statusline (`knowmind status --line`) zeigt knowmind als grüne Lampe direkt in Ihrem
KI-Werkzeug: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-LED, während
knowmind arbeitet, rot bei Ausfall. `knowmind init --client claude-code` bindet sie
automatisch ein (eine bereits vorhandene eigene Statusline bleibt unangetastet).
## Automatische Pflege einrichten (`knowmind init`)
Damit Ihre KI knowmind selbsttätig pflegt — **Recall vor jeder Aufgabe**, **Sichern nach
jeder sicherungswürdigen Runde** — richtet `knowmind init` die passenden Mechanismen für
Ihren Client ein. Der Befehl erkennt den Client am Projekt- und Home-Verzeichnis
(`.claude/`, `.cursor/`, `~/.codex/`) oder Sie wählen ihn explizit.
```
knowmind init # Client automatisch erkennen
knowmind init --client claude-code # gezielt für Claude Code
knowmind init --client cursor # gezielt für Cursor
knowmind init --dry-run # zeigt nur, was geschähe (schreibt nichts)
```
**Was eingerichtet wird:**
- **Claude Code** — projektlokale Hooks in `.claude/`:
- *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
Top-Treffer als Kontext nach (Memory-First, automatisch).
- *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
gespeichert wurde.
- ein **Memory-First-Block** in `./CLAUDE.md` (mit `<!-- BEGIN/END knowmind -->`-Markern).
- **Cursor** — `.cursor/rules/knowmind.mdc` mit der Memory-First-Regel (`alwaysApply`).
- **Claude Desktop / Codex / generisch** — kein automatischer Hook-Mechanismus vorhanden;
der Befehl zeigt den Memory-First-Text zum manuellen Einfügen (siehe Grenze unten).
**Idempotent & nicht-destruktiv:** Ein zweiter Lauf erzeugt keine Duplikate
(marker-/befehls-basierte Ersetzung); bestehende fremde Dateien und Hooks bleiben
unangetastet. Mit `--dry-run` sehen Sie jede Aktion vorab.
> **Grenze der Automatik:** Eine *harte* Erzwingung der Pflege gibt es nur in Clients mit
> Hook-/Rule-Mechanismus (Claude Code, Cursor). In Clients ohne solchen Mechanismus
> (z. B. Claude Desktop, Codex CLI) greifen die **MCP-instructions** (werden beim
> Verbinden gelesen) und die **MCP-prompts** — eine modellabhängige Steuerung ohne
> technische Garantie.
## MCP-Server einrichten
knowmind ist ein MCP-Server (`npx -y knowmind mcp`, stdio). Token aus dem knowmind.de-Dashboard
(→ API-Tokens) als `KNOWMIND_TOKEN`; optional `KNOWMIND_API_URL` (Standard `https://knowmind.de`).
**Claude Code**
```
claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx --env KNOWMIND_API_URL=https://knowmind.de -- npx -y knowmind mcp
```
**Claude Desktop / Cursor / Windsurf / Cline / Continue / Goose / Zed** (`claude_desktop_config.json`, `~/.cursor/mcp.json`, …)
```json
{
"mcpServers": {
"knowmind": {
"command": "npx",
"args": ["-y", "knowmind", "mcp"],
"env": { "KNOWMIND_TOKEN": "kmt_xxx", "KNOWMIND_API_URL": "https://knowmind.de" }
}
}
}
```
> Windows-Hinweis: falls `npx` nicht direkt startet, `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
**VS Code / GitHub Copilot** (`.vscode/mcp.json` — Top-Level `servers` + `inputs`)
```json
{
"inputs": [{ "id": "knowmind_token", "type": "promptString", "description": "Knowmind API token", "password": true }],
"servers": {
"knowmind": {
"command": "npx",
"args": ["-y", "knowmind", "mcp"],
"env": { "KNOWMIND_TOKEN": "${input:knowmind_token}", "KNOWMIND_API_URL": "https://knowmind.de" }
}
}
}
```
**Codex CLI** (`~/.codex/config.toml`)
```toml
[mcp_servers.knowmind]
command = "npx"
args = ["-y", "knowmind", "mcp"]
env = { KNOWMIND_TOKEN = "kmt_xxx", KNOWMIND_API_URL = "https://knowmind.de" }
```
**Gemini CLI** (`~/.gemini/settings.json`) — gleiche `mcpServers`-Struktur wie Claude Desktop.
**Remote (ohne lokale Installation)** — für Clients mit HTTP-MCP-Support direkt der gehostete Endpoint:
```json
{ "type": "http", "url": "https://knowmind.de/api/mcp/v1", "headers": { "Authorization": "Bearer kmt_xxx" } }
```
Token kann statt per `env` auch lokal via `knowmind login --token kmt_xxx` (→ `~/.knowmind/config.json`) hinterlegt werden.
## Tools (im MCP-Modus)
Der MCP-Modus ist seit 0.1.18 ein reiner Proxy auf die Plattform: Tool-Namen,
Schemas und Safety-Annotations kommen direkt vom Server und sind damit immer
identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
- `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
- `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
- `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
- `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
- `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
- `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
- `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
- `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
- `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
- `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
- `knowmind_health` — Verfügbarkeits-Status der Plattform
Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
## Daten in Deutschland
knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
ausschließlich auf Servern in Deutschland (Hetzner-Rechenzentrum) gespeichert und verlassen Deutschland nicht.
Auftragsverarbeitung (AVV) nach Art. 28 DSGVO verfügbar: https://knowmind.de/legal/avv
**Hinweis (Bring-your-own-Key):** Wenn Sie eigene Schlüssel externer KI-Anbieter hinterlegen, werden Ihre
Anfragen direkt an den von Ihnen gewählten Anbieter übermittelt. Sitzt dieser außerhalb der EU, kann dabei
ein Drittlandtransfer stattfinden, für den Sie als Verantwortlicher zuständig sind.
## Haftung & Nutzung (Disclaimer)
- **Software:** Dieses Paket steht unter der **Apache-Lizenz 2.0** und wird „AS IS" ohne jegliche
Gewährleistung bereitgestellt; die Haftung ist im Rahmen der Lizenz (Abschnitte 7 und 8)
ausgeschlossen bzw. beschränkt. Siehe `LICENSE`.
- **Eigenes Konto, eigener Token:** knowmind bündelt keine Zugangsdaten. Sie nutzen Ihren eigenen
knowmind.de-Account und API-Token. Anlegen: https://knowmind.de/dashboard/api-tokens
- **Eigene Kosten/Verbrauch:** Jede Nutzung (API-Anfragen, Token-/Kontingentverbrauch, ggf.
modellbezogene Kosten) erfolgt über Ihren eigenen Account und auf Ihre Verantwortung. Verbrauch
und Kosten sind im knowmind.de-Dashboard transparent einsehbar.
- **Service-Bedingungen:** Für die Nutzung der gehosteten Plattform gelten die AGB und die
Datenschutzerklärung von knowmind.de:
[AGB](https://knowmind.de/legal/agb) · [Datenschutz](https://knowmind.de/legal/datenschutz) ·
[AVV](https://knowmind.de/legal/avv) · [Impressum](https://knowmind.de/legal/impressum)
- **Kein Einsatz in sicherheitskritischen Bereichen:** knowmind ist ein Gedächtnis-/Recall-Dienst und
**nicht** für den Betrieb von selbstfahrenden Fahrzeugen, kritischer Infrastruktur, medizinischen oder
lebenserhaltenden Systemen oder sonstigen Anwendungen bestimmt, bei denen ein Fehler oder Ausfall zu Tod,
Personen-, Umwelt- oder schweren Sachschäden führen kann. Ein Einsatz in solchen Umgebungen erfolgt auf
alleiniges Risiko des Nutzers.
Anbieter: Schübeler Consulting — Johann Jörgen Schübeler. Kontakt: info@schuebeler-consulting.de