Release wordcraft-mcp and gridcraft-mcp 0.3.0: client-neutral skills, Cursor plugins.
This commit is contained in:
Dominic Gundel committed
1 parent
debdf92877
commit
4c7e3ff720
26 files changed
+1008
-236
No files matched your search
@@ -4,59 +4,61 @@
|
||||
|
||||
## Zweck
|
||||
|
||||
Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung von Änderungen und der Fallen, die beim Praxistest mit WordCraft 0.8.0 aufgefallen sind. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
|
||||
Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung und der Fallen aus dem Praxistest mit WordCraft 0.8.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
|
||||
|
||||
## 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))
|
||||
- Claude Desktop **oder** Cursor (siehe unten)
|
||||
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP
|
||||
|
||||
Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.
|
||||
Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren bzw. löschen.
|
||||
|
||||
## Installation
|
||||
**Cursor:** siehe [Wurzel-README](../../README.md) und [docs/CURSOR.md](../../docs/CURSOR.md).
|
||||
|
||||
## Installation (Claude Desktop)
|
||||
|
||||
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
|
||||
|
||||
1. `wordcraft-mcp-v0.2.0.mcpb` und `wordcraft-mcp-v0.2.0.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.
|
||||
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). Lese- und Schreib-Ordner setzen; Schreibordner vorher anlegen und nicht gleich dem Leseordner wählen.
|
||||
1. `wordcraft-mcp-v0.3.0.mcpb` und `wordcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) laden.
|
||||
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). **Lese-Ordner weit** (z. B. Dokumente oder Benutzerordner), **Schreib-Ordner eng** (eigener Ordner, z. B. `Dokumente\Claude`).
|
||||
3. Unter Einstellungen → Erweiterungen prüfen, dass **WordCraft for Claude** eingeschaltet ist.
|
||||
4. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
||||
5. Claude komplett beenden (auch Taskleiste) und neu starten.
|
||||
4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
||||
5. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.
|
||||
|
||||
Wer v0.1.0 installiert hat: alte Erweiterung unter Einstellungen → Erweiterungen entfernen, v0.2.0 installieren, einschalten, Skill-ZIP v0.2.0 hochladen (ersetzt den alten Skill). Alte Skills `wordcraft-dokumente` bitte löschen.
|
||||
Bei `open_document` / `save_document` in Claude „Immer fragen“ lassen, wenn du Pfade mitkontrollieren willst.
|
||||
|
||||
**Umsteigen von der manuellen Config:** Wer den Server früher in `claude_desktop_config.json` eingetragen hat: Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie der Datei anlegen), sonst gibt es die Werkzeuge doppelt.
|
||||
Wer v0.1.0 oder v0.2.0 installiert hat: alte Erweiterung entfernen, v0.3.0 installieren, einschalten, Skill-ZIP v0.3.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen.
|
||||
|
||||
**Umsteigen von der manuellen Config:** Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie), sonst gibt es die Werkzeuge doppelt.
|
||||
|
||||
## Enthaltene Software
|
||||
|
||||
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/`.
|
||||
Die Erweiterung steuert [WordCraft](https://github.com/storytold/wordcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`.
|
||||
|
||||
## Test
|
||||
|
||||
Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“
|
||||
Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“ Die Werkzeuge heißen mit Präfix `…WordCraft_for_Claude…`.
|
||||
|
||||
Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
||||
Fehlen die Tools: Einstellungen → Erweiterungen – eingeschaltet? CLI unter `C:\Program Files\WordCraft\wordcraft-cli.exe` vorhanden? Dann Claude neu starten und neuen Chat öffnen.
|
||||
|
||||
## Stolpersteine
|
||||
|
||||
- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen prüfen.
|
||||
- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen.
|
||||
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
||||
|
||||
## Deinstallation/Update
|
||||
|
||||
Deinstallation: Einstellungen → Erweiterungen → entfernen; Skill in der Skill-Liste löschen.
|
||||
|
||||
Update: neue `.mcpb` und Skill-ZIP installieren, bestehende Version ersetzen lassen, Claude neu starten.
|
||||
Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue `.mcpb` und Skill-ZIP, ersetzen lassen, 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).
|
||||
Statt der Erweiterung den MCP-Server in `claude_desktop_config.json` eintragen. 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` (der Suffix `pzs8sxrjxfjjc` ist der Herausgeber-Hash und bei allen Store-Installationen gleich)
|
||||
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json` (Herausgeber-Hash `pzs8sxrjxfjjc`, bei allen Store-Installationen gleich)
|
||||
|
||||
WordCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\WordCraft\wordcraft-cli.exe`). Der Schreibordner muss vorher existieren.
|
||||
Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben – dann neu eintragen und **sofort** neu starten.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -67,14 +69,14 @@ WordCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\W
|
||||
"mcp",
|
||||
"--author", "Claude",
|
||||
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
|
||||
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
|
||||
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Auffinden der EXE:
|
||||
Laufende App steuern (nicht auf Ordner beschränkt): `wordcraft --control 7981` und `wordcraft-cli mcp --connect 127.0.0.1:7981`.
|
||||
|
||||
```powershell
|
||||
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue
|
||||
|
||||
Reference in new issue
Block a user