knowmind 0.3.6 → 0.3.7
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 +278 -273
- package/README.de.md +207 -207
- package/README.md +207 -207
- package/package.json +63 -63
- 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 +466 -466
package/src/mcp-starter.py
CHANGED
|
@@ -1,119 +1,119 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""Startet den knowmind-MCP-Server unter Windows ohne Konsolenfenster.
|
|
3
|
-
|
|
4
|
-
WARUM (10.08.2026, Johann): „Mein Fenster öffnet sich noch immer, wenn knowmind
|
|
5
|
-
gecalled wird. Viele werden es deshalb deinstallieren." — und nachgeschoben:
|
|
6
|
-
„Du kannst währenddessen auch nicht tippen. Sehr nervig." Das Fenster stiehlt
|
|
7
|
-
den Tastaturfokus, es ist also kein Schönheitsfehler, sondern eine Unterbrechung
|
|
8
|
-
mitten im Satz.
|
|
9
|
-
|
|
10
|
-
Ein MCP-Server wird als `node …/knowmind.js mcp` gestartet. `node.exe` ist ein
|
|
11
|
-
Konsolenprogramm; hat der startende KI-Client keine eigene Konsole — Desktop-
|
|
12
|
-
Anwendung, IDE-Erweiterung —, gibt Windows dem Kind ein eigenes Fenster. Bei
|
|
13
|
-
jedem Werkzeugaufruf blitzt es auf. Ein Gedächtnis, das bei jeder Nutzung den
|
|
14
|
-
Fokus klaut, fliegt wieder runter, egal wie gut es ist.
|
|
15
|
-
|
|
16
|
-
`node.exe` hat kein fensterloses Gegenstück. `pythonw.exe` ist ein GUI-Programm
|
|
17
|
-
und öffnet selbst keins — es gibt node eine versteckte Konsole.
|
|
18
|
-
|
|
19
|
-
WARUM DURCHREICHEN STATT VERERBEN: Die naheliegende Fassung startet node ohne
|
|
20
|
-
stdin/stdout-Umleitung, damit es die Handles des Elternprozesses erbt. Unter
|
|
21
|
-
`pythonw.exe` schlägt das fehl — als GUI-Programm hat es keine verlässlichen
|
|
22
|
-
Standard-Handles, node erbt ins Leere und die Antwort kommt nie beim Client an
|
|
23
|
-
(gemessen 10.08.2026: initialize blieb unbeantwortet). Deshalb werden die
|
|
24
|
-
Datenströme über Pipes geführt und in beide Richtungen durchgepumpt. Roh, ohne
|
|
25
|
-
Zeilenpufferung — MCP-Nachrichten dürfen nicht verzögert oder zerschnitten
|
|
26
|
-
werden.
|
|
27
|
-
|
|
28
|
-
Aufruf: pythonw.exe mcp-starter.py <befehl> [argumente]
|
|
29
|
-
z. B. … mcp-starter.py npx -y knowmind mcp
|
|
30
|
-
oder … mcp-starter.py node C:/…/knowmind.js mcp
|
|
31
|
-
"""
|
|
32
|
-
import shutil
|
|
33
|
-
import subprocess
|
|
34
|
-
import sys
|
|
35
|
-
import threading
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
def pumpe(quelle, ziel) -> None:
|
|
40
|
-
"""Schiebt Bytes weiter, sobald sie da sind, und schliesst am Ende sauber."""
|
|
41
|
-
try:
|
|
42
|
-
while True:
|
|
43
|
-
brocken = quelle.read(1)
|
|
44
|
-
if not brocken:
|
|
45
|
-
break
|
|
46
|
-
ziel.write(brocken)
|
|
47
|
-
ziel.flush()
|
|
48
|
-
except Exception: # noqa: BLE001 — Abbruch beim Beenden ist normal
|
|
49
|
-
pass
|
|
50
|
-
finally:
|
|
51
|
-
try:
|
|
52
|
-
ziel.close()
|
|
53
|
-
except Exception: # noqa: BLE001
|
|
54
|
-
pass
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
def _ohne_fenster():
|
|
58
|
-
"""Startet node in einer versteckten Konsole statt ganz ohne.
|
|
59
|
-
|
|
60
|
-
`CREATE_NO_WINDOW` allein nimmt dem Prozess die Konsole — und ein Kind,
|
|
61
|
-
dessen Eltern keine hat, legt sich eine neue an, die sichtbar ist. Am
|
|
62
|
-
02.09.2026 blitzte deshalb bei jedem Aufruf ein Fenster auf; gemessen
|
|
63
|
-
wurde: konsolenlos einmal Blitz in drei Läufen, versteckte Konsole
|
|
64
|
-
keinmal.
|
|
65
|
-
|
|
66
|
-
`CREATE_NEW_CONSOLE` mit `SW_HIDE` gibt dem Prozess eine eigene, aber
|
|
67
|
-
unsichtbare Konsole, die seine Kinder erben.
|
|
68
|
-
"""
|
|
69
|
-
if sys.platform != "win32":
|
|
70
|
-
return {}
|
|
71
|
-
info = subprocess.STARTUPINFO()
|
|
72
|
-
info.dwFlags |= subprocess.STARTF_USESHOWWINDOW
|
|
73
|
-
info.wShowWindow = subprocess.SW_HIDE
|
|
74
|
-
return {"startupinfo": info,
|
|
75
|
-
"creationflags": subprocess.CREATE_NEW_CONSOLE}
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
def main() -> int:
|
|
79
|
-
if len(sys.argv) < 2:
|
|
80
|
-
sys.stderr.write("Aufruf: mcp-starter.py <knowmind.js> [args...]\n")
|
|
81
|
-
return 2
|
|
82
|
-
|
|
83
|
-
# Erstes Argument ist der zu startende Befehl (node, npx, …), Rest sind
|
|
84
|
-
# dessen Argumente. Unter Windows liegt npx als .cmd vor; subprocess findet
|
|
85
|
-
# es nur über den vollen Pfad, deshalb erst auflösen.
|
|
86
|
-
befehl = list(sys.argv[1:])
|
|
87
|
-
aufgeloest = shutil.which(befehl[0])
|
|
88
|
-
if aufgeloest:
|
|
89
|
-
befehl[0] = aufgeloest
|
|
90
|
-
|
|
91
|
-
try:
|
|
92
|
-
prozess = subprocess.Popen(
|
|
93
|
-
befehl,
|
|
94
|
-
stdin=subprocess.PIPE,
|
|
95
|
-
stdout=subprocess.PIPE,
|
|
96
|
-
stderr=sys.stderr,
|
|
97
|
-
bufsize=0,
|
|
98
|
-
**_ohne_fenster(),
|
|
99
|
-
)
|
|
100
|
-
except FileNotFoundError:
|
|
101
|
-
sys.stderr.write(f"node nicht gefunden: {node}\n")
|
|
102
|
-
return 127
|
|
103
|
-
|
|
104
|
-
faeden = [
|
|
105
|
-
threading.Thread(target=pumpe, args=(sys.stdin.buffer, prozess.stdin), daemon=True),
|
|
106
|
-
threading.Thread(target=pumpe, args=(prozess.stdout, sys.stdout.buffer), daemon=True),
|
|
107
|
-
]
|
|
108
|
-
for f in faeden:
|
|
109
|
-
f.start()
|
|
110
|
-
|
|
111
|
-
try:
|
|
112
|
-
return prozess.wait()
|
|
113
|
-
except KeyboardInterrupt:
|
|
114
|
-
prozess.terminate()
|
|
115
|
-
return 0
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
if __name__ == "__main__":
|
|
119
|
-
raise SystemExit(main())
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""Startet den knowmind-MCP-Server unter Windows ohne Konsolenfenster.
|
|
3
|
+
|
|
4
|
+
WARUM (10.08.2026, Johann): „Mein Fenster öffnet sich noch immer, wenn knowmind
|
|
5
|
+
gecalled wird. Viele werden es deshalb deinstallieren." — und nachgeschoben:
|
|
6
|
+
„Du kannst währenddessen auch nicht tippen. Sehr nervig." Das Fenster stiehlt
|
|
7
|
+
den Tastaturfokus, es ist also kein Schönheitsfehler, sondern eine Unterbrechung
|
|
8
|
+
mitten im Satz.
|
|
9
|
+
|
|
10
|
+
Ein MCP-Server wird als `node …/knowmind.js mcp` gestartet. `node.exe` ist ein
|
|
11
|
+
Konsolenprogramm; hat der startende KI-Client keine eigene Konsole — Desktop-
|
|
12
|
+
Anwendung, IDE-Erweiterung —, gibt Windows dem Kind ein eigenes Fenster. Bei
|
|
13
|
+
jedem Werkzeugaufruf blitzt es auf. Ein Gedächtnis, das bei jeder Nutzung den
|
|
14
|
+
Fokus klaut, fliegt wieder runter, egal wie gut es ist.
|
|
15
|
+
|
|
16
|
+
`node.exe` hat kein fensterloses Gegenstück. `pythonw.exe` ist ein GUI-Programm
|
|
17
|
+
und öffnet selbst keins — es gibt node eine versteckte Konsole.
|
|
18
|
+
|
|
19
|
+
WARUM DURCHREICHEN STATT VERERBEN: Die naheliegende Fassung startet node ohne
|
|
20
|
+
stdin/stdout-Umleitung, damit es die Handles des Elternprozesses erbt. Unter
|
|
21
|
+
`pythonw.exe` schlägt das fehl — als GUI-Programm hat es keine verlässlichen
|
|
22
|
+
Standard-Handles, node erbt ins Leere und die Antwort kommt nie beim Client an
|
|
23
|
+
(gemessen 10.08.2026: initialize blieb unbeantwortet). Deshalb werden die
|
|
24
|
+
Datenströme über Pipes geführt und in beide Richtungen durchgepumpt. Roh, ohne
|
|
25
|
+
Zeilenpufferung — MCP-Nachrichten dürfen nicht verzögert oder zerschnitten
|
|
26
|
+
werden.
|
|
27
|
+
|
|
28
|
+
Aufruf: pythonw.exe mcp-starter.py <befehl> [argumente]
|
|
29
|
+
z. B. … mcp-starter.py npx -y knowmind mcp
|
|
30
|
+
oder … mcp-starter.py node C:/…/knowmind.js mcp
|
|
31
|
+
"""
|
|
32
|
+
import shutil
|
|
33
|
+
import subprocess
|
|
34
|
+
import sys
|
|
35
|
+
import threading
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def pumpe(quelle, ziel) -> None:
|
|
40
|
+
"""Schiebt Bytes weiter, sobald sie da sind, und schliesst am Ende sauber."""
|
|
41
|
+
try:
|
|
42
|
+
while True:
|
|
43
|
+
brocken = quelle.read(1)
|
|
44
|
+
if not brocken:
|
|
45
|
+
break
|
|
46
|
+
ziel.write(brocken)
|
|
47
|
+
ziel.flush()
|
|
48
|
+
except Exception: # noqa: BLE001 — Abbruch beim Beenden ist normal
|
|
49
|
+
pass
|
|
50
|
+
finally:
|
|
51
|
+
try:
|
|
52
|
+
ziel.close()
|
|
53
|
+
except Exception: # noqa: BLE001
|
|
54
|
+
pass
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def _ohne_fenster():
|
|
58
|
+
"""Startet node in einer versteckten Konsole statt ganz ohne.
|
|
59
|
+
|
|
60
|
+
`CREATE_NO_WINDOW` allein nimmt dem Prozess die Konsole — und ein Kind,
|
|
61
|
+
dessen Eltern keine hat, legt sich eine neue an, die sichtbar ist. Am
|
|
62
|
+
02.09.2026 blitzte deshalb bei jedem Aufruf ein Fenster auf; gemessen
|
|
63
|
+
wurde: konsolenlos einmal Blitz in drei Läufen, versteckte Konsole
|
|
64
|
+
keinmal.
|
|
65
|
+
|
|
66
|
+
`CREATE_NEW_CONSOLE` mit `SW_HIDE` gibt dem Prozess eine eigene, aber
|
|
67
|
+
unsichtbare Konsole, die seine Kinder erben.
|
|
68
|
+
"""
|
|
69
|
+
if sys.platform != "win32":
|
|
70
|
+
return {}
|
|
71
|
+
info = subprocess.STARTUPINFO()
|
|
72
|
+
info.dwFlags |= subprocess.STARTF_USESHOWWINDOW
|
|
73
|
+
info.wShowWindow = subprocess.SW_HIDE
|
|
74
|
+
return {"startupinfo": info,
|
|
75
|
+
"creationflags": subprocess.CREATE_NEW_CONSOLE}
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def main() -> int:
|
|
79
|
+
if len(sys.argv) < 2:
|
|
80
|
+
sys.stderr.write("Aufruf: mcp-starter.py <knowmind.js> [args...]\n")
|
|
81
|
+
return 2
|
|
82
|
+
|
|
83
|
+
# Erstes Argument ist der zu startende Befehl (node, npx, …), Rest sind
|
|
84
|
+
# dessen Argumente. Unter Windows liegt npx als .cmd vor; subprocess findet
|
|
85
|
+
# es nur über den vollen Pfad, deshalb erst auflösen.
|
|
86
|
+
befehl = list(sys.argv[1:])
|
|
87
|
+
aufgeloest = shutil.which(befehl[0])
|
|
88
|
+
if aufgeloest:
|
|
89
|
+
befehl[0] = aufgeloest
|
|
90
|
+
|
|
91
|
+
try:
|
|
92
|
+
prozess = subprocess.Popen(
|
|
93
|
+
befehl,
|
|
94
|
+
stdin=subprocess.PIPE,
|
|
95
|
+
stdout=subprocess.PIPE,
|
|
96
|
+
stderr=sys.stderr,
|
|
97
|
+
bufsize=0,
|
|
98
|
+
**_ohne_fenster(),
|
|
99
|
+
)
|
|
100
|
+
except FileNotFoundError:
|
|
101
|
+
sys.stderr.write(f"node nicht gefunden: {node}\n")
|
|
102
|
+
return 127
|
|
103
|
+
|
|
104
|
+
faeden = [
|
|
105
|
+
threading.Thread(target=pumpe, args=(sys.stdin.buffer, prozess.stdin), daemon=True),
|
|
106
|
+
threading.Thread(target=pumpe, args=(prozess.stdout, sys.stdout.buffer), daemon=True),
|
|
107
|
+
]
|
|
108
|
+
for f in faeden:
|
|
109
|
+
f.start()
|
|
110
|
+
|
|
111
|
+
try:
|
|
112
|
+
return prozess.wait()
|
|
113
|
+
except KeyboardInterrupt:
|
|
114
|
+
prozess.terminate()
|
|
115
|
+
return 0
|
|
116
|
+
|
|
117
|
+
|
|
118
|
+
if __name__ == "__main__":
|
|
119
|
+
raise SystemExit(main())
|