knowmind 0.3.6 → 0.3.8
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 +286 -273
- package/README.de.md +231 -207
- package/README.md +229 -207
- package/package.json +63 -63
- package/scripts/registry-fassung-vorhanden.mjs +92 -0
- package/scripts/tools-abgleich.mjs +66 -66
- package/src/client.js +143 -143
- package/src/init.js +831 -831
- package/src/install.js +371 -371
- package/src/mcp-starter.py +119 -119
- package/src/mcp-stdio.js +387 -387
- package/src/tools-fallback.json +657 -466
package/README.de.md
CHANGED
|
@@ -1,207 +1,231 @@
|
|
|
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 `
|
|
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
|
-
- `
|
|
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
|
-
- `
|
|
163
|
-
- `
|
|
164
|
-
- `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
|
|
165
|
-
- `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
|
|
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
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
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_memories` 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_memories` — 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_entities` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
|
|
163
|
+
- `knowmind_unlink_entities` — 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_get_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
|
|
167
|
+
- `knowmind_get_health` — Verfügbarkeits-Status der Plattform
|
|
168
|
+
- `knowmind_upsert_entity` — Knoten für eine Sache anlegen (Person, Firma, Anwendung, Rechner, Technik) oder den vorhandenen zurückgeben
|
|
169
|
+
- `knowmind_get_schema` — Welche Entitätsklassen und Beziehungstypen dieser Arbeitsbereich kennt
|
|
170
|
+
|
|
171
|
+
Inverse-Beziehungen (z. B. `IS_EMPLOYEE_OF` zu `HAS_EMPLOYEE`) werden
|
|
172
|
+
serverseitig automatisch mit angelegt. Hinweis: `knowmind upload` als
|
|
173
|
+
CLI-Befehl läuft über die REST-Schnittstelle (`/api/documents`), nicht über MCP.
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
### Die bisherigen Werkzeugnamen
|
|
177
|
+
|
|
178
|
+
Sieben Werkzeuge haben am 12. September 2026 neue Namen bekommen, damit jeder
|
|
179
|
+
Name dem Muster `knowmind_<verb>_<objekt>` folgt und sagt, ob er liest oder
|
|
180
|
+
schreibt. Die bisherigen Namen antworten bis zum 31. März 2027 unverändert
|
|
181
|
+
weiter und stehen weiter in der Discovery, als veraltet gekennzeichnet:
|
|
182
|
+
|
|
183
|
+
| bisher | ab jetzt |
|
|
184
|
+
| --- | --- |
|
|
185
|
+
| `knowmind_recall` | `knowmind_recall_memories` |
|
|
186
|
+
| `knowmind_health` | `knowmind_get_health` |
|
|
187
|
+
| `knowmind_stats` | `knowmind_get_stats` |
|
|
188
|
+
| `knowmind_schema` | `knowmind_get_schema` |
|
|
189
|
+
| `knowmind_entity` | `knowmind_upsert_entity` |
|
|
190
|
+
| `knowmind_link` | `knowmind_link_entities` |
|
|
191
|
+
| `knowmind_unlink` | `knowmind_unlink_entities` |
|
|
192
|
+
|
|
193
|
+
Aus `knowmind_entity` wurde `upsert` und nicht `get`: Das Werkzeug legt den
|
|
194
|
+
Knoten an oder gibt den vorhandenen zurück. Sonst ändert sich nichts —
|
|
195
|
+
dieselben Parameter, dasselbe Verhalten.
|
|
196
|
+
|
|
197
|
+
## Daten in Deutschland
|
|
198
|
+
|
|
199
|
+
knowmind wird in Deutschland betrieben: Ihre Inhalte (Memories, Account- und Metadaten) werden
|
|
200
|
+
ausschließlich auf Servern in Deutschland (Hetzner-Rechenzentrum) gespeichert und verlassen Deutschland nicht.
|
|
201
|
+
Auftragsverarbeitung (AVV) nach Art. 28 DSGVO verfügbar: https://knowmind.de/legal/avv
|
|
202
|
+
|
|
203
|
+
**Hinweis (Bring-your-own-Key):** Wenn Sie eigene Schlüssel externer KI-Anbieter hinterlegen, werden Ihre
|
|
204
|
+
Anfragen direkt an den von Ihnen gewählten Anbieter übermittelt. Sitzt dieser außerhalb der EU, kann dabei
|
|
205
|
+
ein Drittlandtransfer stattfinden, für den Sie als Verantwortlicher zuständig sind.
|
|
206
|
+
|
|
207
|
+
## Haftung & Nutzung (Disclaimer)
|
|
208
|
+
|
|
209
|
+
- **Software:** Dieses Paket steht unter der **Apache-Lizenz 2.0** und wird „AS IS" ohne jegliche
|
|
210
|
+
Gewährleistung bereitgestellt; die Haftung ist im Rahmen der Lizenz (Abschnitte 7 und 8)
|
|
211
|
+
ausgeschlossen bzw. beschränkt. Siehe `LICENSE`.
|
|
212
|
+
- **Eigenes Konto, eigener Token:** knowmind bündelt keine Zugangsdaten. Sie nutzen Ihren eigenen
|
|
213
|
+
knowmind.de-Account und API-Token. Anlegen: https://knowmind.de/dashboard/api-tokens
|
|
214
|
+
- **Eigene Kosten/Verbrauch:** Jede Nutzung (API-Anfragen, Token-/Kontingentverbrauch, ggf.
|
|
215
|
+
modellbezogene Kosten) erfolgt über Ihren eigenen Account und auf Ihre Verantwortung. Verbrauch
|
|
216
|
+
und Kosten sind im knowmind.de-Dashboard transparent einsehbar.
|
|
217
|
+
- **Service-Bedingungen:** Für die Nutzung der gehosteten Plattform gelten die AGB und die
|
|
218
|
+
Datenschutzerklärung von knowmind.de:
|
|
219
|
+
[AGB](https://knowmind.de/legal/agb) · [Datenschutz](https://knowmind.de/legal/datenschutz) ·
|
|
220
|
+
[AVV](https://knowmind.de/legal/avv) · [Impressum](https://knowmind.de/legal/impressum)
|
|
221
|
+
- **Kein Einsatz in sicherheitskritischen Bereichen:** knowmind ist ein Gedächtnis-/Recall-Dienst und
|
|
222
|
+
**nicht** für den Betrieb von selbstfahrenden Fahrzeugen, kritischer Infrastruktur, medizinischen oder
|
|
223
|
+
lebenserhaltenden Systemen oder sonstigen Anwendungen bestimmt, bei denen ein Fehler oder Ausfall zu Tod,
|
|
224
|
+
Personen-, Umwelt- oder schweren Sachschäden führen kann. Ein Einsatz in solchen Umgebungen erfolgt auf
|
|
225
|
+
alleiniges Risiko des Nutzers.
|
|
226
|
+
|
|
227
|
+
Anbieter: Schübeler Consulting — Johann Jörgen Schübeler. Kontakt: info@schuebeler-consulting.de
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
Die englische Fassung steht in [README.md](README.md).
|