knowmind 0.3.4 → 0.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +273 -260
- package/README.de.md +207 -0
- package/README.md +175 -171
- package/package.json +5 -3
- package/scripts/check-distribution.mjs +114 -0
- package/scripts/sync-server-json.mjs +74 -0
- package/scripts/tools-abgleich.mjs +66 -0
- package/src/install.js +37 -2
- package/src/mcp-starter.py +119 -0
- package/src/mcp-stdio.js +387 -356
- package/src/tools-fallback.json +466 -0
package/README.de.md
ADDED
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# knowmind
|
|
2
|
+
|
|
3
|
+
**Ihr KI-Assistent kennt Ihr Unternehmen nicht.** Er beginnt jedes Gespräch bei null, und Sie
|
|
4
|
+
erklären ihm zum wiederholten Mal dieselben Zusammenhänge. knowmind ist das Gedächtnis darunter:
|
|
5
|
+
Was Sie einmal ablegen, steht in Claude, ChatGPT, Cursor und Ihren eigenen Anwendungen zur
|
|
6
|
+
Verfügung. Betrieben in Deutschland, im Rechenzentrum Nürnberg.
|
|
7
|
+
|
|
8
|
+
**Der Privat-Tarif kostet dauerhaft nichts und verlangt keine Zahlungsdaten.** Schnittstelle,
|
|
9
|
+
Kommandozeile und MCP-Server sind in jedem Tarif enthalten, auch dort.
|
|
10
|
+
|
|
11
|
+
<!-- mcp-name: io.github.Schubeler-Consulting/knowmind -->
|
|
12
|
+
|
|
13
|
+
[](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de) · dieses Paket unter Apache-2.0
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
npm install -g knowmind
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Oder ohne Installation direkt als MCP-Server: `npx -y knowmind mcp`
|
|
22
|
+
|
|
23
|
+
## Einrichtung
|
|
24
|
+
|
|
25
|
+
1. Kostenloses Konto auf [knowmind.de](https://knowmind.de) anlegen und dort einen Zugangsschlüssel
|
|
26
|
+
erzeugen: Dashboard → API-Tokens
|
|
27
|
+
2. Lokal speichern:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
knowmind login --token kmt_xxxxxxxx
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Alternativ über ENV:
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
export KNOWMIND_TOKEN=kmt_xxxxxxxx
|
|
37
|
+
export KNOWMIND_API_URL=https://knowmind.de
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Befehle
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
npx -y knowmind install <ide> MCP-Server im KI-Client verdrahten (claude, cursor, vscode …)
|
|
44
|
+
knowmind init Automatische Gedächtnis-Pflege im KI-Client einrichten
|
|
45
|
+
knowmind search "Wo läuft die OKR-App?"
|
|
46
|
+
knowmind upload notizen.md --title "Meeting Notizen 2026-05-12"
|
|
47
|
+
knowmind stats
|
|
48
|
+
knowmind health
|
|
49
|
+
knowmind status Lebenszeichen des Gedächtnisses (Report)
|
|
50
|
+
knowmind status --line Einzeilige Statusline für Ihr KI-Werkzeug
|
|
51
|
+
knowmind config
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Die Statusline (`knowmind status --line`) zeigt knowmind als grüne Lampe direkt in Ihrem
|
|
55
|
+
KI-Werkzeug: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-LED, während
|
|
56
|
+
knowmind arbeitet, rot bei Ausfall. `knowmind init --client claude-code` bindet sie
|
|
57
|
+
automatisch ein (eine bereits vorhandene eigene Statusline bleibt unangetastet).
|
|
58
|
+
|
|
59
|
+
## Automatische Pflege einrichten (`knowmind init`)
|
|
60
|
+
|
|
61
|
+
Damit Ihre KI knowmind selbsttätig pflegt — **Recall vor jeder Aufgabe**, **Sichern nach
|
|
62
|
+
jeder sicherungswürdigen Runde** — richtet `knowmind init` die passenden Mechanismen für
|
|
63
|
+
Ihren Client ein. Der Befehl erkennt den Client am Projekt- und Home-Verzeichnis
|
|
64
|
+
(`.claude/`, `.cursor/`, `~/.codex/`) oder Sie wählen ihn explizit.
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
knowmind init # Client automatisch erkennen
|
|
68
|
+
knowmind init --client claude-code # gezielt für Claude Code
|
|
69
|
+
knowmind init --client cursor # gezielt für Cursor
|
|
70
|
+
knowmind init --dry-run # zeigt nur, was geschähe (schreibt nichts)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
**Was eingerichtet wird:**
|
|
74
|
+
|
|
75
|
+
- **Claude Code** — projektlokale Hooks in `.claude/`:
|
|
76
|
+
- *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
|
|
77
|
+
Top-Treffer als Kontext nach (Memory-First, automatisch).
|
|
78
|
+
- *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
|
|
79
|
+
Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
|
|
80
|
+
gespeichert wurde.
|
|
81
|
+
- ein **Memory-First-Block** in `./CLAUDE.md` (mit `<!-- BEGIN/END knowmind -->`-Markern).
|
|
82
|
+
- **Cursor** — `.cursor/rules/knowmind.mdc` mit der Memory-First-Regel (`alwaysApply`).
|
|
83
|
+
- **Claude Desktop / Codex / generisch** — kein automatischer Hook-Mechanismus vorhanden;
|
|
84
|
+
der Befehl zeigt den Memory-First-Text zum manuellen Einfügen (siehe Grenze unten).
|
|
85
|
+
|
|
86
|
+
**Idempotent & nicht-destruktiv:** Ein zweiter Lauf erzeugt keine Duplikate
|
|
87
|
+
(marker-/befehls-basierte Ersetzung); bestehende fremde Dateien und Hooks bleiben
|
|
88
|
+
unangetastet. Mit `--dry-run` sehen Sie jede Aktion vorab.
|
|
89
|
+
|
|
90
|
+
> **Grenze der Automatik:** Eine *harte* Erzwingung der Pflege gibt es nur in Clients mit
|
|
91
|
+
> Hook-/Rule-Mechanismus (Claude Code, Cursor). In Clients ohne solchen Mechanismus
|
|
92
|
+
> (z. B. Claude Desktop, Codex CLI) greifen die **MCP-instructions** (werden beim
|
|
93
|
+
> Verbinden gelesen) und die **MCP-prompts** — eine modellabhängige Steuerung ohne
|
|
94
|
+
> technische Garantie.
|
|
95
|
+
|
|
96
|
+
## MCP-Server einrichten
|
|
97
|
+
|
|
98
|
+
knowmind ist ein MCP-Server (`npx -y knowmind mcp`, stdio). Token aus dem knowmind.de-Dashboard
|
|
99
|
+
(→ API-Tokens) als `KNOWMIND_TOKEN`; optional `KNOWMIND_API_URL` (Standard `https://knowmind.de`).
|
|
100
|
+
|
|
101
|
+
**Claude Code**
|
|
102
|
+
```
|
|
103
|
+
claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx --env KNOWMIND_API_URL=https://knowmind.de -- npx -y knowmind mcp
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
**Claude Desktop / Cursor / Windsurf / Cline / Continue / Goose / Zed** (`claude_desktop_config.json`, `~/.cursor/mcp.json`, …)
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"mcpServers": {
|
|
110
|
+
"knowmind": {
|
|
111
|
+
"command": "npx",
|
|
112
|
+
"args": ["-y", "knowmind", "mcp"],
|
|
113
|
+
"env": { "KNOWMIND_TOKEN": "kmt_xxx", "KNOWMIND_API_URL": "https://knowmind.de" }
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
```
|
|
118
|
+
> Windows-Hinweis: falls `npx` nicht direkt startet, `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
|
|
119
|
+
|
|
120
|
+
**VS Code / GitHub Copilot** (`.vscode/mcp.json` — Top-Level `servers` + `inputs`)
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"inputs": [{ "id": "knowmind_token", "type": "promptString", "description": "Knowmind API token", "password": true }],
|
|
124
|
+
"servers": {
|
|
125
|
+
"knowmind": {
|
|
126
|
+
"command": "npx",
|
|
127
|
+
"args": ["-y", "knowmind", "mcp"],
|
|
128
|
+
"env": { "KNOWMIND_TOKEN": "${input:knowmind_token}", "KNOWMIND_API_URL": "https://knowmind.de" }
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
**Codex CLI** (`~/.codex/config.toml`)
|
|
135
|
+
```toml
|
|
136
|
+
[mcp_servers.knowmind]
|
|
137
|
+
command = "npx"
|
|
138
|
+
args = ["-y", "knowmind", "mcp"]
|
|
139
|
+
env = { KNOWMIND_TOKEN = "kmt_xxx", KNOWMIND_API_URL = "https://knowmind.de" }
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**Gemini CLI** (`~/.gemini/settings.json`) — gleiche `mcpServers`-Struktur wie Claude Desktop.
|
|
143
|
+
|
|
144
|
+
**Remote (ohne lokale Installation)** — für Clients mit HTTP-MCP-Support direkt der gehostete Endpoint:
|
|
145
|
+
```json
|
|
146
|
+
{ "type": "http", "url": "https://knowmind.de/api/mcp/v1", "headers": { "Authorization": "Bearer kmt_xxx" } }
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
Token kann statt per `env` auch lokal via `knowmind login --token kmt_xxx` (→ `~/.knowmind/config.json`) hinterlegt werden.
|
|
150
|
+
|
|
151
|
+
## Tools (im MCP-Modus)
|
|
152
|
+
|
|
153
|
+
Der MCP-Modus ist seit 0.1.18 ein reiner Proxy auf die Plattform: Tool-Namen,
|
|
154
|
+
Schemas und Safety-Annotations kommen direkt vom Server und sind damit immer
|
|
155
|
+
identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
|
|
156
|
+
|
|
157
|
+
- `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
|
|
158
|
+
- `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
|
|
159
|
+
- `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
|
|
160
|
+
- `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
|
|
161
|
+
- `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
|
|
162
|
+
- `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
|
|
163
|
+
- `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
|
|
164
|
+
- `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
|
|
165
|
+
- `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
|
|
166
|
+
- `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
|
|
167
|
+
- `knowmind_health` — Verfügbarkeits-Status der Plattform
|
|
168
|
+
|
|
169
|
+
Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
|
|
170
|
+
serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
|
|
171
|
+
CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
|
|
172
|
+
|
|
173
|
+
## Daten in Deutschland
|
|
174
|
+
|
|
175
|
+
knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
|
|
176
|
+
ausschließlich auf Servern in Deutschland (Hetzner-Rechenzentrum) gespeichert und verlassen Deutschland nicht.
|
|
177
|
+
Auftragsverarbeitung (AVV) nach Art. 28 DSGVO verfügbar: https://knowmind.de/legal/avv
|
|
178
|
+
|
|
179
|
+
**Hinweis (Bring-your-own-Key):** Wenn Sie eigene Schlüssel externer KI-Anbieter hinterlegen, werden Ihre
|
|
180
|
+
Anfragen direkt an den von Ihnen gewählten Anbieter übermittelt. Sitzt dieser außerhalb der EU, kann dabei
|
|
181
|
+
ein Drittlandtransfer stattfinden, für den Sie als Verantwortlicher zuständig sind.
|
|
182
|
+
|
|
183
|
+
## Haftung & Nutzung (Disclaimer)
|
|
184
|
+
|
|
185
|
+
- **Software:** Dieses Paket steht unter der **Apache-Lizenz 2.0** und wird „AS IS" ohne jegliche
|
|
186
|
+
Gewährleistung bereitgestellt; die Haftung ist im Rahmen der Lizenz (Abschnitte 7 und 8)
|
|
187
|
+
ausgeschlossen bzw. beschränkt. Siehe `LICENSE`.
|
|
188
|
+
- **Eigenes Konto, eigener Token:** knowmind bündelt keine Zugangsdaten. Sie nutzen Ihren eigenen
|
|
189
|
+
knowmind.de-Account und API-Token. Anlegen: https://knowmind.de/dashboard/api-tokens
|
|
190
|
+
- **Eigene Kosten/Verbrauch:** Jede Nutzung (API-Anfragen, Token-/Kontingentverbrauch, ggf.
|
|
191
|
+
modellbezogene Kosten) erfolgt über Ihren eigenen Account und auf Ihre Verantwortung. Verbrauch
|
|
192
|
+
und Kosten sind im knowmind.de-Dashboard transparent einsehbar.
|
|
193
|
+
- **Service-Bedingungen:** Für die Nutzung der gehosteten Plattform gelten die AGB und die
|
|
194
|
+
Datenschutzerklärung von knowmind.de:
|
|
195
|
+
[AGB](https://knowmind.de/legal/agb) · [Datenschutz](https://knowmind.de/legal/datenschutz) ·
|
|
196
|
+
[AVV](https://knowmind.de/legal/avv) · [Impressum](https://knowmind.de/legal/impressum)
|
|
197
|
+
- **Kein Einsatz in sicherheitskritischen Bereichen:** knowmind ist ein Gedächtnis-/Recall-Dienst und
|
|
198
|
+
**nicht** für den Betrieb von selbstfahrenden Fahrzeugen, kritischer Infrastruktur, medizinischen oder
|
|
199
|
+
lebenserhaltenden Systemen oder sonstigen Anwendungen bestimmt, bei denen ein Fehler oder Ausfall zu Tod,
|
|
200
|
+
Personen-, Umwelt- oder schweren Sachschäden führen kann. Ein Einsatz in solchen Umgebungen erfolgt auf
|
|
201
|
+
alleiniges Risiko des Nutzers.
|
|
202
|
+
|
|
203
|
+
Anbieter: Schübeler Consulting — Johann Jörgen Schübeler. Kontakt: info@schuebeler-consulting.de
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
Die englische Fassung steht in [README.md](README.md).
|
package/README.md
CHANGED
|
@@ -1,203 +1,207 @@
|
|
|
1
1
|
# knowmind
|
|
2
2
|
|
|
3
|
-
**Ihr KI-Assistent kennt Ihr Unternehmen nicht.** Er beginnt jedes Gespräch bei null, und Sie
|
|
4
|
-
erklären ihm zum wiederholten Mal dieselben Zusammenhänge. knowmind ist das Gedächtnis darunter:
|
|
5
|
-
Was Sie einmal ablegen, steht in Claude, ChatGPT, Cursor und Ihren eigenen Anwendungen zur
|
|
6
|
-
Verfügung. Betrieben in Deutschland, im Rechenzentrum Nürnberg.
|
|
7
|
-
|
|
8
|
-
**Der Privat-Tarif kostet dauerhaft nichts und verlangt keine Zahlungsdaten.** Schnittstelle,
|
|
9
|
-
Kommandozeile und MCP-Server sind in jedem Tarif enthalten, auch dort.
|
|
10
3
|
|
|
11
4
|
<!-- mcp-name: io.github.Schubeler-Consulting/knowmind -->
|
|
12
5
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
## Installation
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
npm install -g knowmind
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Oder ohne Installation direkt als MCP-Server: `npx -y knowmind mcp`
|
|
6
|
+
**Persistent memory for your AI tools.** Store something once, and it is available in Claude Code, Cursor, and any other MCP client that runs a local (stdio) server — as a typed knowledge graph with provenance, confidence, and a bitemporal history for every fact. Hosted in Germany (Hetzner, Nuremberg data center); the CLI and MCP server in this repository are Apache-2.0.
|
|
22
7
|
|
|
23
|
-
|
|
8
|
+
**The free tier is permanently free and requires no payment details.** The API, CLI, and MCP server are included in every tier.
|
|
24
9
|
|
|
25
|
-
|
|
26
|
-
erzeugen: Dashboard → API-Tokens
|
|
27
|
-
2. Lokal speichern:
|
|
10
|
+
[](https://www.npmjs.com/package/knowmind) · [knowmind.de](https://knowmind.de)
|
|
28
11
|
|
|
29
|
-
|
|
30
|
-
knowmind login --token kmt_xxxxxxxx
|
|
31
|
-
```
|
|
12
|
+
## Connect your AI tool in three steps
|
|
32
13
|
|
|
33
|
-
|
|
14
|
+
1. Create a free account at [knowmind.de](https://knowmind.de) and generate an access token: Dashboard → API tokens.
|
|
15
|
+
2. Store the token locally:
|
|
34
16
|
|
|
35
17
|
```
|
|
36
|
-
|
|
37
|
-
export KNOWMIND_API_URL=https://knowmind.de
|
|
18
|
+
npx -y knowmind login --token kmt_xxxxxxxx
|
|
38
19
|
```
|
|
39
20
|
|
|
40
|
-
|
|
21
|
+
3. Wire up your client:
|
|
41
22
|
|
|
23
|
+
**Claude Code** (one command)
|
|
42
24
|
```
|
|
43
|
-
|
|
44
|
-
knowmind init Automatische Gedächtnis-Pflege im KI-Client einrichten
|
|
45
|
-
knowmind search "Wo läuft die OKR-App?"
|
|
46
|
-
knowmind upload notizen.md --title "Meeting Notizen 2026-05-12"
|
|
47
|
-
knowmind stats
|
|
48
|
-
knowmind health
|
|
49
|
-
knowmind status Lebenszeichen des Gedächtnisses (Report)
|
|
50
|
-
knowmind status --line Einzeilige Statusline für Ihr KI-Werkzeug
|
|
51
|
-
knowmind config
|
|
25
|
+
claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx -- npx -y knowmind mcp
|
|
52
26
|
```
|
|
53
27
|
|
|
54
|
-
|
|
55
|
-
KI-Werkzeug: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-LED, während
|
|
56
|
-
knowmind arbeitet, rot bei Ausfall. `knowmind init --client claude-code` bindet sie
|
|
57
|
-
automatisch ein (eine bereits vorhandene eigene Statusline bleibt unangetastet).
|
|
58
|
-
|
|
59
|
-
## Automatische Pflege einrichten (`knowmind init`)
|
|
60
|
-
|
|
61
|
-
Damit Ihre KI knowmind selbsttätig pflegt — **Recall vor jeder Aufgabe**, **Sichern nach
|
|
62
|
-
jeder sicherungswürdigen Runde** — richtet `knowmind init` die passenden Mechanismen für
|
|
63
|
-
Ihren Client ein. Der Befehl erkennt den Client am Projekt- und Home-Verzeichnis
|
|
64
|
-
(`.claude/`, `.cursor/`, `~/.codex/`) oder Sie wählen ihn explizit.
|
|
65
|
-
|
|
66
|
-
```
|
|
67
|
-
knowmind init # Client automatisch erkennen
|
|
68
|
-
knowmind init --client claude-code # gezielt für Claude Code
|
|
69
|
-
knowmind init --client cursor # gezielt für Cursor
|
|
70
|
-
knowmind init --dry-run # zeigt nur, was geschähe (schreibt nichts)
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
**Was eingerichtet wird:**
|
|
74
|
-
|
|
75
|
-
- **Claude Code** — projektlokale Hooks in `.claude/`:
|
|
76
|
-
- *UserPromptSubmit* → ruft vor jeder inhaltlichen Frage `knowmind_recall` auf und reicht die
|
|
77
|
-
Top-Treffer als Kontext nach (Memory-First, automatisch).
|
|
78
|
-
- *Stop* → erinnert die KI daran, mit `knowmind_store_memory` zu sichern, wenn die Runde
|
|
79
|
-
Sicherungswürdiges enthielt (Deploy/Commit, neue Regel, Entscheidung) und noch nichts
|
|
80
|
-
gespeichert wurde.
|
|
81
|
-
- ein **Memory-First-Block** in `./CLAUDE.md` (mit `<!-- BEGIN/END knowmind -->`-Markern).
|
|
82
|
-
- **Cursor** — `.cursor/rules/knowmind.mdc` mit der Memory-First-Regel (`alwaysApply`).
|
|
83
|
-
- **Claude Desktop / Codex / generisch** — kein automatischer Hook-Mechanismus vorhanden;
|
|
84
|
-
der Befehl zeigt den Memory-First-Text zum manuellen Einfügen (siehe Grenze unten).
|
|
85
|
-
|
|
86
|
-
**Idempotent & nicht-destruktiv:** Ein zweiter Lauf erzeugt keine Duplikate
|
|
87
|
-
(marker-/befehls-basierte Ersetzung); bestehende fremde Dateien und Hooks bleiben
|
|
88
|
-
unangetastet. Mit `--dry-run` sehen Sie jede Aktion vorab.
|
|
89
|
-
|
|
90
|
-
> **Grenze der Automatik:** Eine *harte* Erzwingung der Pflege gibt es nur in Clients mit
|
|
91
|
-
> Hook-/Rule-Mechanismus (Claude Code, Cursor). In Clients ohne solchen Mechanismus
|
|
92
|
-
> (z. B. Claude Desktop, Codex CLI) greifen die **MCP-instructions** (werden beim
|
|
93
|
-
> Verbinden gelesen) und die **MCP-prompts** — eine modellabhängige Steuerung ohne
|
|
94
|
-
> technische Garantie.
|
|
95
|
-
|
|
96
|
-
## MCP-Server einrichten
|
|
97
|
-
|
|
98
|
-
knowmind ist ein MCP-Server (`npx -y knowmind mcp`, stdio). Token aus dem knowmind.de-Dashboard
|
|
99
|
-
(→ API-Tokens) als `KNOWMIND_TOKEN`; optional `KNOWMIND_API_URL` (Standard `https://knowmind.de`).
|
|
100
|
-
|
|
101
|
-
**Claude Code**
|
|
102
|
-
```
|
|
103
|
-
claude mcp add knowmind --env KNOWMIND_TOKEN=kmt_xxx --env KNOWMIND_API_URL=https://knowmind.de -- npx -y knowmind mcp
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
**Claude Desktop / Cursor / Windsurf / Cline / Continue / Goose / Zed** (`claude_desktop_config.json`, `~/.cursor/mcp.json`, …)
|
|
28
|
+
**Cursor** (`~/.cursor/mcp.json`) — also works for Claude Desktop, Windsurf, Cline, Continue, Goose, and Zed with their respective config files:
|
|
107
29
|
```json
|
|
108
30
|
{
|
|
109
31
|
"mcpServers": {
|
|
110
32
|
"knowmind": {
|
|
111
33
|
"command": "npx",
|
|
112
34
|
"args": ["-y", "knowmind", "mcp"],
|
|
113
|
-
"env": { "KNOWMIND_TOKEN": "kmt_xxx"
|
|
35
|
+
"env": { "KNOWMIND_TOKEN": "kmt_xxx" }
|
|
114
36
|
}
|
|
115
37
|
}
|
|
116
38
|
}
|
|
117
39
|
```
|
|
118
|
-
> Windows-Hinweis: falls `npx` nicht direkt startet, `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
|
|
119
40
|
|
|
120
|
-
**
|
|
121
|
-
```json
|
|
122
|
-
{
|
|
123
|
-
"inputs": [{ "id": "knowmind_token", "type": "promptString", "description": "Knowmind API token", "password": true }],
|
|
124
|
-
"servers": {
|
|
125
|
-
"knowmind": {
|
|
126
|
-
"command": "npx",
|
|
127
|
-
"args": ["-y", "knowmind", "mcp"],
|
|
128
|
-
"env": { "KNOWMIND_TOKEN": "${input:knowmind_token}", "KNOWMIND_API_URL": "https://knowmind.de" }
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
```
|
|
41
|
+
**Any other MCP client**: knowmind is a standard MCP server over stdio (`npx -y knowmind mcp`). On Windows, if `npx` does not start directly, use `"command": "cmd"`, `"args": ["/c", "npx", "-y", "knowmind", "mcp"]`.
|
|
133
42
|
|
|
134
|
-
|
|
135
|
-
```toml
|
|
136
|
-
[mcp_servers.knowmind]
|
|
137
|
-
command = "npx"
|
|
138
|
-
args = ["-y", "knowmind", "mcp"]
|
|
139
|
-
env = { KNOWMIND_TOKEN = "kmt_xxx", KNOWMIND_API_URL = "https://knowmind.de" }
|
|
140
|
-
```
|
|
43
|
+
`npx -y knowmind install <ide>` writes this configuration for you (e.g. `claude`, `cursor`, `vscode`), and `npx -y knowmind init` sets up automatic memory hygiene — recall before each task, store after each meaningful change — for clients with a hook or rule mechanism (Claude Code, Cursor).
|
|
141
44
|
|
|
142
|
-
|
|
45
|
+
## How knowmind stores facts
|
|
143
46
|
|
|
144
|
-
**
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
47
|
+
- **Bitemporal history.** Every fact carries two time axes: when it was true and when it was recorded. Corrections never overwrite the original; the old statement stays queryable with the date it stopped being valid, so you can reconstruct what the system knew on any given day.
|
|
48
|
+
- **Provenance and confidence per fact.** New facts require a confidence level and keep a link to their source. Older facts without a confidence level are marked as such.
|
|
49
|
+
- **Typed knowledge graph.** Entities and relations use a restricted set of edge types; catch-all relations are rejected at write time.
|
|
50
|
+
- **Operated in the EU, isolated per tenant.** The service runs on Hetzner in Nuremberg, Germany, with tenant isolation, a public data processing agreement, and a subprocessor list at [knowmind.de/legal/avv](https://knowmind.de/legal/avv). Access logs are hash-chained and externally timestamped (RFC 3161).
|
|
51
|
+
|
|
52
|
+
knowmind is a hosted service; there is no self-hosted community edition. If you need self-hosting, one of the projects below will serve you better. knowmind is built for the people and teams that need an operated memory service with an audit trail in the EU.
|
|
53
|
+
|
|
54
|
+
## Pricing
|
|
148
55
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
56
|
+
| Tier | Price | For whom |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| Free | €0 | individuals and evaluation |
|
|
59
|
+
| Pro | €15/month or €150/year | individual professionals |
|
|
60
|
+
| Team | €99/month | teams with shared memory |
|
|
61
|
+
| Business | €349/month | larger teams |
|
|
62
|
+
| Enterprise | from €1,000/month | organizations with on-premise requirements |
|
|
63
|
+
|
|
64
|
+
The free tier includes 2,500 memories, 1 user, and a 30-day access log.
|
|
65
|
+
|
|
66
|
+
How that compares (vendor pricing pages, checked 2026-09-05):
|
|
67
|
+
|
|
68
|
+
| Product | Free tier | First paid tier | Self-hosting |
|
|
69
|
+
|---|---|---|---|
|
|
70
|
+
| knowmind | 2,500 memories | €15/month | no (Enterprise on-premise option) |
|
|
71
|
+
| Mem0 | 10,000 entries, 1,000 retrievals/month | $19/month | yes (Apache-2.0) |
|
|
72
|
+
| Zep | 10,000 credits/month | $125/month | Graphiti open source; Zep as BYOC |
|
|
73
|
+
| cognee | 1M tokens, 1 workspace | $2.50 per 1M tokens | yes |
|
|
74
|
+
| Letta | limited agents, own keys | $20/month | yes (per vendor) |
|
|
75
|
+
| Supermemory | ~$5 usage included | $19/month | from Scale tier |
|
|
76
|
+
|
|
77
|
+
Details and current prices: [knowmind.de/pricing](https://knowmind.de/pricing).
|
|
78
|
+
|
|
79
|
+
## Commands
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
npx -y knowmind search "Where does the staging deploy run?"
|
|
83
|
+
npx -y knowmind upload notes.md --title "Meeting notes 2026-05-12"
|
|
84
|
+
npx -y knowmind stats
|
|
85
|
+
npx -y knowmind health
|
|
86
|
+
npx -y knowmind status --line # one-line status for your AI tool's statusline
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Available Tools
|
|
90
|
+
|
|
91
|
+
Thirteen tools over MCP. Every one works against your own workspace; the server
|
|
92
|
+
never sees another tenant's data.
|
|
93
|
+
|
|
94
|
+
### Reading
|
|
95
|
+
|
|
96
|
+
**`knowmind_recall`** — Search your memory and get the passages that answer a
|
|
97
|
+
question, ranked. Combines keyword search, vector similarity and the knowledge
|
|
98
|
+
graph, then reranks with a cross-encoder.
|
|
99
|
+
`query` (string, required) · `k` (integer, default 5, max 20) · `hops` (integer,
|
|
100
|
+
default 2 — how far to follow graph edges from a hit)
|
|
101
|
+
*Usage:* your AI tool asks "Which database does the billing service use?" before
|
|
102
|
+
answering, instead of guessing.
|
|
103
|
+
*Errors:* returns an empty result set when nothing matches — never an invented
|
|
104
|
+
answer.
|
|
105
|
+
|
|
106
|
+
**`knowmind_recall_at_time`** — The same search, but as your memory stood on a
|
|
107
|
+
given date. Facts superseded after that date are excluded; facts that were valid
|
|
108
|
+
then are returned even if they are no longer true.
|
|
109
|
+
`query` (string, required) · `as_of` (ISO date or timestamp, required in
|
|
110
|
+
practice) · `k` (integer, default 5)
|
|
111
|
+
*Usage:* "What was our pricing in March?" — answers from the state of that day,
|
|
112
|
+
not today's.
|
|
113
|
+
*Difference from `knowmind_recall`:* use `recall` for what is true now, and
|
|
114
|
+
`recall_at_time` for what was true then. Asking `recall` about the past returns
|
|
115
|
+
today's facts.
|
|
116
|
+
|
|
117
|
+
**`knowmind_list_recent`** — The most recently added entries, newest first.
|
|
118
|
+
`k` (integer, default 10)
|
|
119
|
+
*Usage:* a quick look at what landed in memory during this session.
|
|
120
|
+
|
|
121
|
+
**`knowmind_list_relations`** — All typed edges attached to one entry, in both
|
|
122
|
+
directions.
|
|
123
|
+
`memory_id` (string, required)
|
|
124
|
+
*Usage:* "What does this contract connect to?" before changing or superseding it.
|
|
125
|
+
*Errors:* unknown id returns an error, not an empty list.
|
|
126
|
+
|
|
127
|
+
**`knowmind_schema`** — The entity classes and relation types this workspace
|
|
128
|
+
accepts. No parameters.
|
|
129
|
+
*Usage:* call it before `knowmind_entity` or `knowmind_link` to use a type the
|
|
130
|
+
server will accept, rather than inventing one.
|
|
131
|
+
|
|
132
|
+
**`knowmind_stats`** — Size of the corpus: documents, chunks, entities, edges.
|
|
133
|
+
No parameters.
|
|
134
|
+
|
|
135
|
+
**`knowmind_health`** — Whether the service and its stores are reachable. No
|
|
136
|
+
parameters.
|
|
137
|
+
*Usage:* a status line, or a check before a long ingest.
|
|
138
|
+
|
|
139
|
+
### Writing
|
|
140
|
+
|
|
141
|
+
**`knowmind_store_memory`** — Store a short fact, decision or note. Stays as one
|
|
142
|
+
unit; it is not split.
|
|
143
|
+
`content` (string, required) · `title` (string) · `memory_type` (string, e.g.
|
|
144
|
+
`semantic`, `episodic`) · `tags` (array of strings) · `source` (string) ·
|
|
145
|
+
`domain` (string) · `relations` (array — edges to create along with the entry)
|
|
146
|
+
*Usage:* "We decided to keep the monolith until Q3" after a meeting.
|
|
147
|
+
*Errors:* rejected with 422 when the text contains what looks like a password or
|
|
148
|
+
an access key. Store a pointer instead, not the secret.
|
|
149
|
+
|
|
150
|
+
**`knowmind_upload_document`** — Store a longer text as a document. It is split
|
|
151
|
+
into passages, embedded, and becomes searchable through `knowmind_recall`.
|
|
152
|
+
`content` (string, required) · `title` (string) · `source` (string) ·
|
|
153
|
+
`relations` (array)
|
|
154
|
+
*Usage:* meeting minutes, a specification, a handbook chapter.
|
|
155
|
+
*Difference from `knowmind_store_memory`:* one sentence you want back verbatim is
|
|
156
|
+
a memory; a page you want searched is a document. A long text stored as a memory
|
|
157
|
+
is retrieved as one block, which crowds out other results.
|
|
158
|
+
|
|
159
|
+
**`knowmind_update_fact`** — Supersede a fact that has changed. The old version
|
|
160
|
+
keeps its validity window and stays auditable; nothing is deleted.
|
|
161
|
+
`target_id` (string, required) · `new_title` (string, required) · `new_content`
|
|
162
|
+
(string, required) · `update_reason` (string)
|
|
163
|
+
*Usage:* a price, a deadline or a responsibility changed. Never overwrite —
|
|
164
|
+
supersede, so "what did we believe in July" stays answerable.
|
|
165
|
+
*Errors:* unknown `target_id` is rejected.
|
|
166
|
+
|
|
167
|
+
**`knowmind_entity`** — Create or update a typed entity (a person, a company, a
|
|
168
|
+
product) with aliases.
|
|
169
|
+
`name` (string, required) · `entity_class` (string, required — see
|
|
170
|
+
`knowmind_schema`) · `description` (string) · `aliases` (array of strings)
|
|
171
|
+
*Usage:* give "ACME Ltd." its aliases so a question about "ACME" finds it.
|
|
172
|
+
*Errors:* a class outside the schema is rejected.
|
|
173
|
+
|
|
174
|
+
**`knowmind_link`** — Create a typed edge between two entries, with a confidence
|
|
175
|
+
value.
|
|
176
|
+
`from_id` (string, required) · `to_id` (string, required) · `rel_type` (string,
|
|
177
|
+
required — see `knowmind_schema`) · `confidence` (number 0–1)
|
|
178
|
+
*Usage:* connect a contract to the client it belongs to. The inverse edge is
|
|
179
|
+
created for you.
|
|
180
|
+
|
|
181
|
+
**`knowmind_unlink`** — Remove a typed edge.
|
|
182
|
+
`from_id`, `to_id`, `rel_type` (all required)
|
|
183
|
+
*Usage:* an edge created in error. The entries themselves stay.
|
|
184
|
+
|
|
185
|
+
### On deleting
|
|
186
|
+
|
|
187
|
+
There is no delete tool, and that is deliberate. Facts are superseded
|
|
188
|
+
(`knowmind_update_fact`), edges are removed (`knowmind_unlink`), and the history
|
|
189
|
+
stays auditable. Deleting an entire workspace including its data is a
|
|
190
|
+
self-service action in the web interface at
|
|
191
|
+
[knowmind.de](https://knowmind.de) — it is not something an agent should be able
|
|
192
|
+
to do by calling a tool.
|
|
193
|
+
|
|
194
|
+
### Discovery
|
|
195
|
+
|
|
196
|
+
`GET https://knowmind.de/api/mcp/v1` returns name, version, protocol version and
|
|
197
|
+
the full tool list with input schemas — without a token. Directory crawlers and
|
|
198
|
+
inspectors can read the complete surface anonymously; only `tools/call` requires
|
|
199
|
+
a key.
|
|
200
|
+
|
|
201
|
+
## Links
|
|
202
|
+
|
|
203
|
+
[Documentation](https://knowmind.de/docs) · [Pricing](https://knowmind.de/pricing) · [Data processing agreement](https://knowmind.de/legal/avv) · [Privacy](https://knowmind.de/legal/datenschutz)
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
Die deutsche Fassung steht in [README.de.md](README.de.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "knowmind",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.6",
|
|
4
4
|
"mcpName": "io.github.Schubeler-Consulting/knowmind",
|
|
5
5
|
"description": "Knowmind — das Agentengehirn aus Deutschland: CLI + MCP-Server (Langzeitgedächtnis & Wissensgraph für Ihre KI, Server in Deutschland).",
|
|
6
6
|
"type": "module",
|
|
@@ -31,10 +31,12 @@
|
|
|
31
31
|
"!src/*.test.js",
|
|
32
32
|
"README.md",
|
|
33
33
|
"CHANGELOG.md",
|
|
34
|
-
"LICENSE"
|
|
34
|
+
"LICENSE",
|
|
35
|
+
"scripts"
|
|
35
36
|
],
|
|
36
37
|
"scripts": {
|
|
37
|
-
"test": "node --test src/*.test.js"
|
|
38
|
+
"test": "node --test src/*.test.js",
|
|
39
|
+
"tools:abgleich": "node scripts/tools-abgleich.mjs"
|
|
38
40
|
},
|
|
39
41
|
"dependencies": {
|
|
40
42
|
"@huggingface/transformers": "^3.5.0"
|