Add Claude Desktop extensions (.mcpb) for WordCraft and GridCraft.
Ship unsigned MCPB packages built from the ArtCraft Launcher CLIs, with install docs and skill 0.2.0 updates.
This commit is contained in:
Dominic Gundel committed
1 parent
3ac6cd5a29
commit
2fd4164ee7
36 files changed
+1412
-116
No files matched your search
@@ -8,61 +8,25 @@ Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Serv
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
- GridCraft inklusive `gridcraft-cli.exe` ist installiert. Der ArtCraft-Launcher legt die Dateien nach `C:\Program Files\GridCraft\` und trägt nichts in den PATH ein.
|
||||
- Claude Desktop ist installiert.
|
||||
- Der MCP-Server ist in der `claude_desktop_config.json` eingetragen.
|
||||
- Claude Desktop (die App)
|
||||
- Die Erweiterung `gridcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))
|
||||
|
||||
**Keine Ordnerbeschränkung.** Anders als WordCraft kennt GridCraft keine `--automation-read-root` und `--automation-write-root`. 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. Der Skill weist Claude an, nie über ein Original zu speichern, sondern immer unter einem neuen Namen.
|
||||
**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.
|
||||
|
||||
## Installation
|
||||
|
||||
Git ist nicht nötig.
|
||||
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
|
||||
|
||||
1. Das ZIP [gridcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/tag/gridcraft-mcp/v0.1.0) aus dem Release laden.
|
||||
2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen.
|
||||
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.
|
||||
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.
|
||||
|
||||
## Einrichtung
|
||||
**Umsteigen von der manuellen Config:** Wer den Server früher in `claude_desktop_config.json` eingetragen hat: Eintrag `gridcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie der Datei anlegen), sonst gibt es die Werkzeuge doppelt.
|
||||
|
||||
In der bestehenden `claude_desktop_config.json` nur einen Eintrag innerhalb von `mcpServers` ergänzen. Bestehende Einträge, zum Beispiel `wordcraft`, bleiben unverändert.
|
||||
## Enthaltene Software
|
||||
|
||||
```json
|
||||
"gridcraft": {
|
||||
"command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
|
||||
"args": ["mcp"]
|
||||
}
|
||||
```
|
||||
|
||||
So sieht `mcpServers` aus, wenn WordCraft schon eingetragen ist. Den vorhandenen `wordcraft`-Block nicht durch dieses Beispiel ersetzen, nur `gridcraft` daneben setzen:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"wordcraft": {
|
||||
"command": "C:\\Program Files\\WordCraft\\wordcraft-cli.exe",
|
||||
"args": [
|
||||
"mcp",
|
||||
"--author", "Claude",
|
||||
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
|
||||
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
|
||||
]
|
||||
},
|
||||
"gridcraft": {
|
||||
"command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
|
||||
"args": ["mcp"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Einrichtung unter Windows – Stolpersteine
|
||||
|
||||
Gemeinsame Punkte (Ort der Config, nur `mcpServers` ergänzen, App überschreibt die Datei): [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
|
||||
|
||||
- Der ArtCraft-Launcher installiert nach `C:\Program Files\GridCraft\` (`gridcraft.exe` und `gridcraft-cli.exe`) und trägt nichts in den PATH ein. `Get-Command gridcraft-cli` findet die Datei daher nicht; in die Config den vollen Pfad schreiben. Auffinden mit:
|
||||
|
||||
```powershell
|
||||
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
|
||||
```
|
||||
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/`.
|
||||
|
||||
## Im Test geprüft
|
||||
|
||||
@@ -80,15 +44,46 @@ Kurzfassung, die Einzelheiten stehen in [SKILL.md](SKILL.md):
|
||||
|
||||
## Test
|
||||
|
||||
Neuen Chat öffnen und fragen: „Sind die GridCraft-Tools verfügbar? Lies A1:E10 aus <Pfad zu einer Test-xlsx>.“
|
||||
Neuen Chat öffnen und fragen: „Sind die GridCraft-Tools verfügbar? Lies A1:E10 aus \<Pfad zu einer Test-xlsx\>.“
|
||||
|
||||
Fehlen die Tools, zuerst den Eintrag in der Config prüfen. Nicht auf ein anderes Programm ausweichen.
|
||||
Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
||||
|
||||
## Stolpersteine
|
||||
|
||||
- Erweiterungen sind nicht signiert; bei Defender-Warnung an Dominic wenden.
|
||||
- Formeln mit deutschen Namen ergeben `#NAME?` – englische Funktionsnamen verlangen.
|
||||
|
||||
## Deinstallation/Update
|
||||
|
||||
Deinstallation: In Claude den Skill aus der Liste entfernen. Den Block `gridcraft` unter `mcpServers` nur löschen, wenn GridCraft nicht mehr benutzt wird. Andere Einträge in der Config nicht anfassen.
|
||||
Deinstallation: Einstellungen → Erweiterungen → entfernen; Skill in der Skill-Liste löschen.
|
||||
|
||||
Update: das ZIP der neuen Version aus dem Release laden und wie bei der Installation hochladen. Liegt die alte Fassung noch in Claude, diese vorher entfernen.
|
||||
Update: neue `.mcpb` und Skill-ZIP installieren, bestehende Version ersetzen lassen, Claude neu starten.
|
||||
|
||||
## Alternative: manuell (für Entwickler)
|
||||
|
||||
Statt der Erweiterung kann der MCP-Server in `claude_desktop_config.json` eingetragen werden. Gemeinsame Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
|
||||
|
||||
- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
|
||||
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`
|
||||
|
||||
GridCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\GridCraft\gridcraft-cli.exe`).
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"gridcraft": {
|
||||
"command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
|
||||
"args": ["mcp"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Auffinden der EXE:
|
||||
|
||||
```powershell
|
||||
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
|
||||
```
|
||||
|
||||
## Änderungen
|
||||
|
||||
|
||||
Reference in new issue
Block a user