Do not bundle CLIs in MCPB packages.

Point extensions at ArtCraft Launcher installs and require WordCraft/GridCraft on the machine.
2026-10-19 16:15:08 +02:00
1 parent 2fd4164ee7
commit 2c02038e8c
@@ -1,5 +1,9 @@
 # Changelog – gridcraft-mcp

+## 0.2.1 (2026-10-19)
+
+- `.mcpb` enthält keine CLI mehr; setzt GridCraft aus dem ArtCraft-Launcher voraus (`C:\Program Files\GridCraft\gridcraft-cli.exe`).
+
 ## 0.2.0 (2026-10-19)

 - Auslieferung als Claude-Desktop-Erweiterung (`.mcpb`) zusätzlich zum Skill-ZIP.
@@ -9,6 +9,7 @@ Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Serv
 ## Voraussetzungen

 - Claude Desktop (die App)
+- **GridCraft** über den ArtCraft-Launcher (`C:\Program Files\GridCraft\gridcraft-cli.exe`)
 - Die Erweiterung `gridcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))

 **Keine Ordnerbeschränkung.** Anders als WordCraft kennt GridCraft keine Lese-/Schreib-Roots. Der Server kann jede Datei lesen und schreiben, die der Windows-Benutzer lesen und schreiben darf. In Claude bei den GridCraft-Werkzeugen `open_workbook`, `save_workbook` und `execute_command` auf „Immer fragen“ lassen.
@@ -17,7 +18,7 @@ Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Serv

 Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

-1. `gridcraft-mcp-v….mcpb` und `gridcraft-mcp-v….zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.mcpb) laden.
+1. `gridcraft-mcp-v….mcpb` und `gridcraft-mcp-v….zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.1/gridcraft-mcp-v0.2.1.mcpb) laden.
 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
 3. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
 4. Claude komplett beenden (auch Taskleiste) und neu starten.
@@ -26,7 +27,7 @@ Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

 ## Enthaltene Software

-Die Erweiterung enthält `gridcraft-cli.exe` aus [GridCraft](https://github.com/storytold/gridcraft) 0.8.0 (MIT oder Apache-2.0). Lizenztexte liegen in der `.mcpb` unter `LICENSES/`.
+Die Erweiterung steuert [GridCraft](https://github.com/storytold/gridcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte des Upstreams liegen in der `.mcpb` unter `LICENSES/`.

 ## Im Test geprüft

@@ -11,7 +11,7 @@ GridCraft ist eine Open-Source-Tabellenkalkulation (Rust), die Excel-Parität an

 Der MCP-Server muss verbunden sein (Tools wie `write_range`, `read_range`, `execute_command`). Je nach Client heißen sie mit Präfix, z. B. `mcp__…__gridcraft__write_range`; sind sie zurückgestellt, erst per ToolSearch laden. Fehlen sie, dem Nutzer sagen, dass der Server nicht läuft, statt auf etwas anderes auszuweichen.

-**Standardweg:** die Claude-Desktop-Erweiterung „GridCraft für Claude“ ist installiert und eingeschaltet (siehe `docs/INSTALLATION.md`). Fehlen die Tools: Einstellungen → Erweiterungen prüfen, Claude komplett beenden (auch Taskleiste) und neu starten.
+**Standardweg:** GridCraft aus dem ArtCraft-Launcher und die Claude-Desktop-Erweiterung „GridCraft für Claude“ sind installiert und eingeschaltet (siehe `docs/INSTALLATION.md`). Fehlen die Tools: ArtCraft-Installation und Einstellungen → Erweiterungen prüfen, Claude komplett beenden (auch Taskleiste) und neu starten.

 **Alternative (Entwickler):** Eintrag `gridcraft` in `claude_desktop_config.json`; die App kann ihn beim Speichern eigener Einstellungen überschreiben.

@@ -0,0 +1,2 @@
+server/*.exe
+**/*.exe
@@ -2,8 +2,8 @@
  "manifest_version": "0.3",
  "name": "gridcraft-mcp",
  "display_name": "GridCraft für Claude",
-  "version": "0.2.0",
-  "description": "Excel-Arbeitsmappen (.xlsx, .csv) erstellen und bearbeiten. Getestet mit GridCraft 0.8.0. Ohne Ordnersperre – GridCraft kann alle Dateien lesen und schreiben, auf die der Benutzer Zugriff hat.",
+  "version": "0.2.1",
+  "description": "Excel-Arbeitsmappen (.xlsx, .csv) erstellen und bearbeiten. Getestet mit GridCraft 0.8.0. Erfordert GridCraft aus dem ArtCraft-Launcher. Ohne Ordnersperre – GridCraft kann alle Dateien lesen und schreiben, auf die der Benutzer Zugriff hat.",
  "author": {
    "name": "Dominic Gundel"
  },
@@ -21,9 +21,9 @@
  },
  "server": {
    "type": "binary",
-    "entry_point": "server/gridcraft-cli.exe",
+    "entry_point": "server/README.txt",
    "mcp_config": {
-      "command": "${__dirname}/server/gridcraft-cli.exe",
+      "command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
      "args": [
        "mcp"
      ]
@@ -0,0 +1,3 @@
+Diese Erweiterung enthaelt keine CLI.
+Installiere GridCraft ueber den ArtCraft-Launcher.
+Erwarteter Pfad: C:\Program Files\GridCraft\gridcraft-cli.exe
@@ -1,9 +1 @@
-{
-  "sha256": "2eafa6b8d08357fb44610e030ebe54491b5abc1329da3d748878228a868d779a",
-  "version": "0.8.0",
-  "source": "ArtCraft-Launcher",
-  "repository": "https://github.com/storytold/gridcraft",
-  "exe": "gridcraft-cli.exe",
-  "path": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
-  "tag": "v0.8.0"
-}
+{"version":"0.8.0","repository":"https://github.com/storytold/gridcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"gridcraft-cli.exe","path":"C:\\Program Files\\GridCraft\\gridcraft-cli.exe","tag":"v0.8.0","sha256":"2eafa6b8d08357fb44610e030ebe54491b5abc1329da3d748878228a868d779a"}
@@ -1,5 +1,9 @@
 # Changelog – wordcraft-mcp

+## 0.2.1 (2026-10-19)
+
+- `.mcpb` enthält keine CLI mehr; setzt WordCraft aus dem ArtCraft-Launcher voraus (`C:\Program Files\WordCraft\wordcraft-cli.exe`).
+
 ## 0.2.0 (2026-10-19)

 - Auslieferung als Claude-Desktop-Erweiterung (`.mcpb`) zusätzlich zum Skill-ZIP.
@@ -9,6 +9,7 @@ Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraf
 ## Voraussetzungen

 - Claude Desktop (die App)
+- **WordCraft** über den ArtCraft-Launcher (`C:\Program Files\WordCraft\wordcraft-cli.exe`)
 - Die Erweiterung `wordcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))

 Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.
@@ -17,7 +18,7 @@ Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, dami

 Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

-1. `wordcraft-mcp-v….mcpb` und `wordcraft-mcp-v….zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.mcpb) laden.
+1. `wordcraft-mcp-v….mcpb` und `wordcraft-mcp-v….zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.1/wordcraft-mcp-v0.2.1.mcpb) laden.
 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). Lese- und Schreib-Ordner setzen; Schreibordner vorher anlegen und nicht gleich dem Leseordner wählen.
 3. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
 4. Claude komplett beenden (auch Taskleiste) und neu starten.
@@ -26,7 +27,7 @@ Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:

 ## Enthaltene Software

-Die Erweiterung enthält `wordcraft-cli.exe` aus [WordCraft](https://github.com/storytold/wordcraft) 0.8.0 (MIT oder Apache-2.0). Lizenztexte liegen in der `.mcpb` unter `LICENSES/`.
+Die Erweiterung steuert [WordCraft](https://github.com/storytold/wordcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte des Upstreams liegen in der `.mcpb` unter `LICENSES/`.

 ## Test

@@ -11,7 +11,7 @@ WordCraft ist ein Open-Source-Textverarbeitungsprogramm (Rust), das Word-Paritä

 Der MCP-Server muss verbunden sein (Tools wie `execute`, `list_commands`, `render_page`). In claude.ai heißen sie `mcp__claude-device__lcl-wordcraft-*` und sind oft **deferred**: zuerst per ToolSearch laden (`select:mcp__claude-device__lcl-wordcraft-list_commands,...`, alle benötigten in einem Aufruf). Fehlen sie auch dann, dem Nutzer den Grund nennen statt auszuweichen.

-**Standardweg:** die Claude-Desktop-Erweiterung „WordCraft für Claude“ ist installiert und eingeschaltet (siehe `docs/INSTALLATION.md`). Fehlen die Tools: Einstellungen → Erweiterungen prüfen, Claude komplett beenden (auch Taskleiste) und neu starten – nicht auf ein anderes Programm ausweichen.
+**Standardweg:** WordCraft aus dem ArtCraft-Launcher und die Claude-Desktop-Erweiterung „WordCraft für Claude“ sind installiert und eingeschaltet (siehe `docs/INSTALLATION.md`). Fehlen die Tools: ArtCraft-Installation und Einstellungen → Erweiterungen prüfen, Claude komplett beenden (auch Taskleiste) und neu starten – nicht auf ein anderes Programm ausweichen.

 **Alternative (Entwickler):** Eintrag `wordcraft` in `claude_desktop_config.json` mit `wordcraft-cli.exe mcp --author Claude --automation-read-root <Ordner> --automation-write-root <Ordner>\claude_out`. Store-Pfad: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\`. Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben – dann neu eintragen und sofort neu starten.

@@ -0,0 +1,2 @@
+server/*.exe
+**/*.exe
@@ -2,8 +2,8 @@
  "manifest_version": "0.3",
  "name": "wordcraft-mcp",
  "display_name": "WordCraft für Claude",
-  "version": "0.2.0",
-  "description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0.",
+  "version": "0.2.1",
+  "description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0. Erfordert WordCraft aus dem ArtCraft-Launcher.",
  "author": {
    "name": "Dominic Gundel"
  },
@@ -21,9 +21,9 @@
  },
  "server": {
    "type": "binary",
-    "entry_point": "server/wordcraft-cli.exe",
+    "entry_point": "server/README.txt",
    "mcp_config": {
-      "command": "${__dirname}/server/wordcraft-cli.exe",
+      "command": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
      "args": [
        "mcp",
        "--author",
@@ -0,0 +1,3 @@
+Diese Erweiterung enthaelt keine CLI.
+Installiere WordCraft ueber den ArtCraft-Launcher.
+Erwarteter Pfad: C:\Program Files\WordCraft\wordcraft-cli.exe
@@ -1,9 +1 @@
-{
-  "sha256": "58716716647575ab68d1638f0b0a5b37b62f05cb4ed896614e7e98da5801221a",
-  "version": "0.8.0",
-  "source": "ArtCraft-Launcher",
-  "repository": "https://github.com/storytold/wordcraft",
-  "exe": "wordcraft-cli.exe",
-  "path": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
-  "tag": "v0.8.0"
-}
+{"version":"0.8.0","repository":"https://github.com/storytold/wordcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"wordcraft-cli.exe","path":"C:\\Program Files\\WordCraft\\wordcraft-cli.exe","tag":"v0.8.0","sha256":"58716716647575ab68d1638f0b0a5b37b62f05cb4ed896614e7e98da5801221a"}