Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
debdf92877 | ||
|
|
73a6d3e9d0 |
No files matched your search
+1
-1
@@ -75,7 +75,7 @@ skills/<name>/
|
|||||||
|
|
||||||
Ein Paket pro Skill, Dateiname `dist/<name>-v<version>.zip`. Im ZIP liegt der Ordner `<name>/` mit `SKILL.md` auf oberster Ebene. `README.md` und `CHANGELOG.md` werden nicht eingepackt.
|
Ein Paket pro Skill, Dateiname `dist/<name>-v<version>.zip`. Im ZIP liegt der Ordner `<name>/` mit `SKILL.md` auf oberster Ebene. `README.md` und `CHANGELOG.md` werden nicht eingepackt.
|
||||||
|
|
||||||
Skills mit `extension/` liefern zusätzlich `dist/<name>-v<version>.mcpb`. Die `.mcpb` enthält **keine** CLI-EXE: sie zeigt auf die Installation aus dem ArtCraft-Launcher (`C:\Program Files\…`). `scripts/fetch-cli` prüft nur, dass die EXE lokal vorhanden ist, und aktualisiert `upstream.json` sowie die Lizenztexte. Die `.mcpb` bleibt unsigniert, solange kein Code-Signing-Zertifikat vorliegt (`mcpb sign` braucht `--cert` / `--key`; `--self-signed` hilft nicht gegen Defender).
|
Skills mit `extension/` liefern zusätzlich `dist/<name>-v<version>.mcpb`. Die `.mcpb` enthält **keine** CLI-EXE: sie zeigt auf die Installation aus dem ArtCraft-Launcher (`C:\Program Files\…`). `scripts/fetch-cli` prüft nur, dass die EXE lokal vorhanden ist, und aktualisiert `upstream.json` sowie die Lizenztexte. Als `entry_point` dient `server/README.txt`: die MCPB-Prüfung verlangt eine Datei im Paket; gestartet wird der Befehl aus `mcp_config.command`. `mcpb validate` besteht damit, und die Erweiterung startet so. Die `.mcpb` bleibt unsigniert, solange kein Code-Signing-Zertifikat vorliegt (`mcpb sign` braucht `--cert` / `--key`; `--self-signed` hilft nicht gegen Defender).
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
scripts/package.sh # nur Skill-ZIPs
|
scripts/package.sh # nur Skill-ZIPs
|
||||||
|
|||||||
@@ -9,8 +9,8 @@ Schritt-für-Schritt-Installation: [docs/INSTALLATION.md](docs/INSTALLATION.md).
|
|||||||
<!-- skills:start -->
|
<!-- skills:start -->
|
||||||
| Skill | Kurzbeschreibung | Version | Doku | Download | Erweiterung (.mcpb) |
|
| Skill | Kurzbeschreibung | Version | Doku | Download | Erweiterung (.mcpb) |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| [gridcraft-mcp](skills/gridcraft-mcp/) | Excel-Arbeitsmappen (.xlsx, .csv) über den GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen, formatieren und prüfen – Kalkulationen, Stücklisten, Listen, Diagramme, PDF-Export. | 0.1.0 | [README](skills/gridcraft-mcp/README.md) | [gridcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.1.0/gridcraft-mcp-v0.1.0.zip) | [gridcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.1.0/gridcraft-mcp-v0.1.0.mcpb) |
|
| [gridcraft-mcp](skills/gridcraft-mcp/) | Excel-Arbeitsmappen (.xlsx, .csv) über den GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen, formatieren und prüfen – Kalkulationen, Stücklisten, Listen, Diagramme, PDF-Export. | 0.2.0 | [README](skills/gridcraft-mcp/README.md) | [gridcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.zip) | [gridcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.mcpb) |
|
||||||
| [wordcraft-mcp](skills/wordcraft-mcp/) | Word-Dokumente (.docx, .odt, .md, PDF) über den WordCraft-MCP-Server erstellen, bearbeiten und prüfen, inkl. Nachverfolgung – mit erprobten Fallen aus WordCraft 0.8.0. | 0.1.0 | [README](skills/wordcraft-mcp/README.md) | [wordcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.1.0/wordcraft-mcp-v0.1.0.zip) | [wordcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.1.0/wordcraft-mcp-v0.1.0.mcpb) |
|
| [wordcraft-mcp](skills/wordcraft-mcp/) | Word-Dokumente (.docx, .odt, .md, PDF) über den WordCraft-MCP-Server erstellen, bearbeiten und prüfen, inkl. Nachverfolgung – mit erprobten Fallen aus WordCraft 0.8.0. | 0.2.0 | [README](skills/wordcraft-mcp/README.md) | [wordcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.zip) | [wordcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.mcpb) |
|
||||||
<!-- skills:end -->
|
<!-- skills:end -->
|
||||||
|
|
||||||
## Skill installieren
|
## Skill installieren
|
||||||
|
|||||||
+27
-19
@@ -1,13 +1,13 @@
|
|||||||
# Claude-Werkzeuge für Word und Excel einrichten
|
# Claude-Werkzeuge für Word und Excel einrichten
|
||||||
|
|
||||||
Mit dieser Anleitung kann Claude Word-Dokumente (über **WordCraft für Claude**) und Excel-Tabellen (über **GridCraft für Claude**) direkt auf deinem Rechner erstellen und bearbeiten. Dauer: etwa 10 Minuten. Du brauchst keine Programmierkenntnisse.
|
Mit dieser Anleitung kann Claude Word-Dokumente (über **WordCraft for Claude**) und Excel-Tabellen (über **GridCraft for Claude**) direkt auf deinem Rechner erstellen und bearbeiten. Dauer: etwa 10 Minuten. Du brauchst keine Programmierkenntnisse.
|
||||||
|
|
||||||
Für jedes Werkzeug installierst du zwei Dinge:
|
Für jedes Werkzeug installierst du zwei Dinge:
|
||||||
|
|
||||||
| Datei | Was sie ist | Wozu |
|
| Datei | Was sie ist | Wozu |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `….mcpb` | **Erweiterung** für die Claude-App | gibt Claude die Werkzeuge (Datei öffnen, schreiben, speichern …) |
|
| `….mcpb` | **Erweiterung** für die Claude-App | gibt Claude die Werkzeuge (Datei öffnen, schreiben, speichern …) |
|
||||||
| `….zip` | **Skill** | Anleitung für Claude, wie man die Werkzeuge richtig benutzt |
|
| `….zip` | **Skill** | Anleitung für Claude, wie man die Werkzeuge richtig benutzt |
|
||||||
|
|
||||||
Ohne Erweiterung kann Claude nichts tun, ohne Skill macht es mehr Fehler. Installiere also immer beides.
|
Ohne Erweiterung kann Claude nichts tun, ohne Skill macht es mehr Fehler. Installiere also immer beides.
|
||||||
|
|
||||||
@@ -17,25 +17,30 @@ Ohne Erweiterung kann Claude nichts tun, ohne Skill macht es mehr Fehler. Instal
|
|||||||
|
|
||||||
- Windows 10 oder 11
|
- Windows 10 oder 11
|
||||||
- **Claude Desktop** installiert und angemeldet (die App, nicht nur der Browser)
|
- **Claude Desktop** installiert und angemeldet (die App, nicht nur der Browser)
|
||||||
- **ArtCraft-Launcher:** darüber **WordCraft** und **GridCraft** installieren (legt die Programme nach `C:\Program Files\WordCraft\` bzw. `C:\Program Files\GridCraft\`). Die Claude-Erweiterung enthält die Programme **nicht**.
|
|
||||||
- Ein eigener Ordner, in den Claude speichern darf, z. B. `Dokumente\Claude-Ausgabe`. Leg ihn jetzt an.
|
- Ein eigener Ordner, in den Claude speichern darf, z. B. `Dokumente\Claude-Ausgabe`. Leg ihn jetzt an.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1. Dateien herunterladen
|
## 1. ArtCraft-Launcher und Apps installieren
|
||||||
|
|
||||||
Öffne die Releases-Seite: **https://git.gundel.dev/dg/claude-skills/releases**
|
Installiere den [ArtCraft-Launcher](https://getartcraft.com/apps) und darin **WordCraft** und **GridCraft**. Den Standardpfad nicht ändern: `C:\Program Files\WordCraft` bzw. `C:\Program Files\GridCraft`. Die Claude-Erweiterung enthält die Programme **nicht**.
|
||||||
|
|
||||||
Lade jeweils die neueste Version herunter:
|
(Installer auch unter [GitHub Releases](https://github.com/storytold/craft-launcher/releases).)
|
||||||
|
|
||||||
- `wordcraft-mcp-vX.Y.Z.mcpb` und `wordcraft-mcp-vX.Y.Z.zip`
|
---
|
||||||
- `gridcraft-mcp-vX.Y.Z.mcpb` und `gridcraft-mcp-vX.Y.Z.zip`
|
|
||||||
|
## 2. Dateien herunterladen
|
||||||
|
|
||||||
|
Lade jeweils die Version **0.2.0** herunter:
|
||||||
|
|
||||||
|
- [wordcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.mcpb) und [wordcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.zip)
|
||||||
|
- [gridcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.mcpb) und [gridcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.2.0/gridcraft-mcp-v0.2.0.zip)
|
||||||
|
|
||||||
Die ZIP-Dateien **nicht entpacken**.
|
Die ZIP-Dateien **nicht entpacken**.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 2. Erweiterungen installieren
|
## 3. Erweiterungen installieren
|
||||||
|
|
||||||
Für jede `.mcpb`-Datei:
|
Für jede `.mcpb`-Datei:
|
||||||
|
|
||||||
@@ -43,17 +48,19 @@ Für jede `.mcpb`-Datei:
|
|||||||
2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen.
|
2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen.
|
||||||
*Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen.
|
*Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen.
|
||||||
3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen.
|
3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen.
|
||||||
4. **Nur bei WordCraft für Claude** fragt Claude nach zwei Ordnern:
|
4. **Nur bei WordCraft for Claude** fragt Claude nach zwei Ordnern:
|
||||||
- **Lese-Ordner:** Hier darf Claude Dokumente lesen, z. B. `Dokumente`.
|
- **Lese-Ordner:** Hier darf Claude Dokumente lesen, z. B. `Dokumente`.
|
||||||
- **Schreib-Ordner:** Nur hier darf Claude speichern – deinen Ordner `Dokumente\Claude-Ausgabe` wählen. Nicht denselben wie den Lese-Ordner, dann bleiben deine Originale sicher.
|
- **Schreib-Ordner:** Nur hier darf Claude speichern – deinen Ordner `Dokumente\Claude-Ausgabe` wählen. Nicht denselben wie den Lese-Ordner, dann bleiben deine Originale sicher.
|
||||||
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen und muss **eingeschaltet** sein.
|
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen.
|
||||||
|
|
||||||
|
**Danach unter Einstellungen → Erweiterungen prüfen, dass beide Erweiterungen eingeschaltet sind.** Frisch installierte Erweiterungen können ausgeschaltet sein.
|
||||||
|
|
||||||
> **Windows meldet „Der Computer wurde durch Windows geschützt“ oder Defender schlägt an?**
|
> **Windows meldet „Der Computer wurde durch Windows geschützt“ oder Defender schlägt an?**
|
||||||
> Die Erweiterungen sind nicht signiert. Nur installieren, wenn du der Quelle vertraust.
|
> Die Erweiterungen sind nicht signiert. Nur installieren, wenn du der Quelle vertraust.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3. Skills installieren
|
## 4. Skills installieren
|
||||||
|
|
||||||
Für jede `.zip`-Datei:
|
Für jede `.zip`-Datei:
|
||||||
|
|
||||||
@@ -64,19 +71,19 @@ Die Skills heißen danach `wordcraft-mcp` und `gridcraft-mcp`.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4. Claude neu starten
|
## 5. Claude neu starten
|
||||||
|
|
||||||
Claude **komplett beenden** – auch das Symbol unten rechts in der Taskleiste (Rechtsklick → Beenden) – und wieder öffnen.
|
Claude **komplett beenden** – auch das Symbol unten rechts in der Taskleiste (Rechtsklick → Beenden) – und wieder öffnen.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 5. Testen
|
## 6. Testen
|
||||||
|
|
||||||
Neuen Chat öffnen und eintippen:
|
Einen **neuen** Chat öffnen (offene Chats sehen neue Werkzeuge evtl. erst später) und eintippen:
|
||||||
|
|
||||||
> Sind die WordCraft- und GridCraft-Werkzeuge verfügbar? Leg zum Test eine kleine Excel-Tabelle mit drei Zeilen in meinem Claude-Ausgabeordner an.
|
> Sind die WordCraft- und GridCraft-Werkzeuge verfügbar? Leg zum Test eine kleine Excel-Tabelle mit drei Zeilen in meinem Claude-Ausgabeordner an.
|
||||||
|
|
||||||
Claude sollte beide Werkzeuge finden und eine `.xlsx`-Datei im Ausgabeordner speichern. Beim ersten Mal fragt Claude, ob es die Werkzeuge benutzen darf – erlauben.
|
Claude sollte beide Werkzeuge finden und eine `.xlsx`-Datei im Ausgabeordner speichern. Beim ersten Mal fragt Claude, ob es die Werkzeuge benutzen darf – erlauben. Die Werkzeuge heißen mit Präfix `…WordCraft_for_Claude…` bzw. `…GridCraft_for_Claude…`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -93,8 +100,9 @@ Claude sollte beide Werkzeuge finden und eine `.xlsx`-Datei im Ausgabeordner spe
|
|||||||
|
|
||||||
| Problem | Lösung |
|
| Problem | Lösung |
|
||||||
|---|---|
|
|---|---|
|
||||||
| Claude sagt, die Werkzeuge fehlen | ArtCraft-Launcher: Sind WordCraft bzw. GridCraft installiert? Einstellungen → Erweiterungen: Ist die Erweiterung eingeschaltet? Dann Claude komplett beenden (auch Taskleiste) und neu starten. |
|
| Claude sagt, die Werkzeuge fehlen | Einstellungen → Erweiterungen: ist die Erweiterung eingeschaltet? Einschalten, dann neuen Chat öffnen. |
|
||||||
| WordCraft speichert nicht („path rejected“) | Claude wollte außerhalb des Schreib-Ordners speichern. Ordner prüfen: Einstellungen → Erweiterungen → WordCraft für Claude → Einstellungen. |
|
| Werkzeuge fehlen, Erweiterung ist eingeschaltet | Prüfen, ob `C:\Program Files\WordCraft\wordcraft-cli.exe` (bzw. `C:\Program Files\GridCraft\gridcraft-cli.exe`) existiert; sonst über den ArtCraft-Launcher installieren. |
|
||||||
|
| WordCraft speichert nicht („path rejected“) | Claude wollte außerhalb des Schreib-Ordners speichern. Ordner prüfen: Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen. |
|
||||||
| Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ |
|
| Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ |
|
||||||
| Zahlen sehen im Chat wie `1,450.00 €` aus | Normal. In Excel erscheinen sie richtig als `1.450,00 €`. |
|
| Zahlen sehen im Chat wie `1,450.00 €` aus | Normal. In Excel erscheinen sie richtig als `1.450,00 €`. |
|
||||||
| Doppelklick auf `.mcpb` tut nichts | Über Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ gehen. |
|
| Doppelklick auf `.mcpb` tut nichts | Über Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ gehen. |
|
||||||
|
|||||||
@@ -54,9 +54,11 @@ Erwarteter Pfad: $src
|
|||||||
"@
|
"@
|
||||||
}
|
}
|
||||||
|
|
||||||
$verOut = & $src --version 2>&1 | Out-String
|
$verResult = Get-ProcessOutputUtf8 $src '--version'
|
||||||
if ($LASTEXITCODE -ne 0 -and $Name -eq 'gridcraft-mcp') {
|
$verOut = $verResult.Output
|
||||||
$verOut = & $src version 2>&1 | Out-String
|
if ($verResult.ExitCode -ne 0 -and $Name -eq 'gridcraft-mcp') {
|
||||||
|
$verResult = Get-ProcessOutputUtf8 $src 'version'
|
||||||
|
$verOut = $verResult.Output
|
||||||
}
|
}
|
||||||
$ver = ''
|
$ver = ''
|
||||||
if ($verOut -match '(\d+\.\d+\.\d+)') { $ver = $Matches[1] }
|
if ($verOut -match '(\d+\.\d+\.\d+)') { $ver = $Matches[1] }
|
||||||
|
|||||||
+13
-2
@@ -53,9 +53,20 @@ if [[ ! -f "$ext/server/README.txt" ]]; then
|
|||||||
"Erwarteter Pfad: $src" > "$ext/server/README.txt"
|
"Erwarteter Pfad: $src" > "$ext/server/README.txt"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
ver_out="$("$src" --version 2>&1 || true)"
|
# CLI-Ausgabe als UTF-8 lesen (kein Locale-Default wie Windows-1252).
|
||||||
|
ver_out="$(PYTHONIOENCODING=utf-8 python3 -c '
|
||||||
|
import subprocess, sys
|
||||||
|
r = subprocess.run(sys.argv[1:], capture_output=True)
|
||||||
|
sys.stdout.buffer.write(r.stdout)
|
||||||
|
sys.stdout.buffer.write(r.stderr)
|
||||||
|
' "$src" --version || true)"
|
||||||
if [[ ! "$ver_out" =~ [0-9]+\.[0-9]+\.[0-9]+ ]] && [[ "$name" == gridcraft-mcp ]]; then
|
if [[ ! "$ver_out" =~ [0-9]+\.[0-9]+\.[0-9]+ ]] && [[ "$name" == gridcraft-mcp ]]; then
|
||||||
ver_out="$("$src" version 2>&1 || true)"
|
ver_out="$(PYTHONIOENCODING=utf-8 python3 -c '
|
||||||
|
import subprocess, sys
|
||||||
|
r = subprocess.run(sys.argv[1:], capture_output=True)
|
||||||
|
sys.stdout.buffer.write(r.stdout)
|
||||||
|
sys.stdout.buffer.write(r.stderr)
|
||||||
|
' "$src" version || true)"
|
||||||
fi
|
fi
|
||||||
if [[ ! "$ver_out" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then
|
if [[ ! "$ver_out" =~ ([0-9]+\.[0-9]+\.[0-9]+) ]]; then
|
||||||
echo "Version der CLI nicht lesbar: $ver_out" >&2
|
echo "Version der CLI nicht lesbar: $ver_out" >&2
|
||||||
|
|||||||
+25
-3
@@ -5,16 +5,38 @@ $ErrorActionPreference = 'Stop'
|
|||||||
$Root = Split-Path -Parent $PSScriptRoot
|
$Root = Split-Path -Parent $PSScriptRoot
|
||||||
$SkillsDir = Join-Path $Root 'skills'
|
$SkillsDir = Join-Path $Root 'skills'
|
||||||
$DistDir = Join-Path $Root 'dist'
|
$DistDir = Join-Path $Root 'dist'
|
||||||
$Utf8NoBom = New-Object System.Text.UTF8Encoding $false
|
$Utf8NoBom = [System.Text.UTF8Encoding]::new($false)
|
||||||
|
|
||||||
# Datei als UTF-8 lesen, Zeilenenden auf LF vereinheitlichen.
|
# Datei als UTF-8 lesen, Zeilenenden auf LF vereinheitlichen.
|
||||||
function Read-Text([string]$Path) {
|
function Read-Text([string]$Path) {
|
||||||
return ([IO.File]::ReadAllText($Path, [Text.Encoding]::UTF8) -replace "`r", '')
|
return ([System.IO.File]::ReadAllText($Path, [System.Text.Encoding]::UTF8) -replace "`r", '')
|
||||||
}
|
}
|
||||||
|
|
||||||
# Datei als UTF-8 ohne BOM mit LF schreiben (Set-Content wuerde in 5.1 ein BOM schreiben).
|
# Datei als UTF-8 ohne BOM mit LF schreiben (Set-Content wuerde in 5.1 ein BOM schreiben).
|
||||||
function Write-Text([string]$Path, [string]$Text) {
|
function Write-Text([string]$Path, [string]$Text) {
|
||||||
[IO.File]::WriteAllText($Path, $Text, $Utf8NoBom)
|
[System.IO.File]::WriteAllText($Path, $Text, $Utf8NoBom)
|
||||||
|
}
|
||||||
|
|
||||||
|
# Prozess starten und stdout+stderr als UTF-8 ohne BOM lesen (kein Out-String / Default-Encoding).
|
||||||
|
# $Arguments ist die Argumentzeile (PS 5.1 hat kein ProcessStartInfo.ArgumentList).
|
||||||
|
function Get-ProcessOutputUtf8([string]$FileName, [string]$Arguments) {
|
||||||
|
$psi = New-Object System.Diagnostics.ProcessStartInfo
|
||||||
|
$psi.FileName = $FileName
|
||||||
|
$psi.Arguments = $Arguments
|
||||||
|
$psi.UseShellExecute = $false
|
||||||
|
$psi.RedirectStandardOutput = $true
|
||||||
|
$psi.RedirectStandardError = $true
|
||||||
|
$psi.CreateNoWindow = $true
|
||||||
|
$psi.StandardOutputEncoding = $Utf8NoBom
|
||||||
|
$psi.StandardErrorEncoding = $Utf8NoBom
|
||||||
|
$p = [System.Diagnostics.Process]::Start($psi)
|
||||||
|
$stdout = $p.StandardOutput.ReadToEnd()
|
||||||
|
$stderr = $p.StandardError.ReadToEnd()
|
||||||
|
$p.WaitForExit()
|
||||||
|
return @{
|
||||||
|
ExitCode = $p.ExitCode
|
||||||
|
Output = ($stdout + $stderr)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
function Test-Bom([string]$Path) {
|
function Test-Bom([string]$Path) {
|
||||||
|
|||||||
@@ -51,6 +51,7 @@ if [[ $check -eq 1 ]]; then
|
|||||||
fi
|
fi
|
||||||
echo "README.md ist aktuell."
|
echo "README.md ist aktuell."
|
||||||
else
|
else
|
||||||
printf '%s\n' "$new" > "$readme"
|
# Explizit UTF-8 schreiben (Locale kann sonst die README verfaelschen).
|
||||||
|
python3 -c 'import sys; open(sys.argv[1],"w",encoding="utf-8",newline="\n").write(sys.stdin.read())' "$readme" <<< "$new"
|
||||||
echo "README.md aktualisiert."
|
echo "README.md aktualisiert."
|
||||||
fi
|
fi
|
||||||
@@ -1,5 +1,12 @@
|
|||||||
# Changelog – gridcraft-mcp
|
# Changelog – gridcraft-mcp
|
||||||
|
|
||||||
|
## 0.2.0 (2026-10-19)
|
||||||
|
|
||||||
|
- Erweiterung (`.mcpb`) als Standardweg; `display_name` ohne Umlaut („GridCraft for Claude“, Werkzeug-Präfix jetzt `…_for_Claude`).
|
||||||
|
- Allgemeine Werkzeugnamen im Skill (Präfix hängt vom Client und vom Erweiterungsnamen ab).
|
||||||
|
- Doku: ArtCraft-Voraussetzung und „Erweiterung einschalten“; UTF-8-Fix in Manifest und README.
|
||||||
|
- Apostroph-Falle für Text mit führendem `=` (Beschriftungen wie `= Materialkosten`).
|
||||||
|
|
||||||
## 0.1.0 (2026-10-19)
|
## 0.1.0 (2026-10-19)
|
||||||
|
|
||||||
- Erste Version: Skill und Claude-Desktop-Erweiterung (`.mcpb`) für GridCraft aus dem ArtCraft-Launcher.
|
- Erste Version: Skill und Claude-Desktop-Erweiterung (`.mcpb`) für GridCraft aus dem ArtCraft-Launcher.
|
||||||
|
|||||||
@@ -4,34 +4,37 @@
|
|||||||
|
|
||||||
## Zweck
|
## Zweck
|
||||||
|
|
||||||
Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Server von GridCraft. GridCraft ist der Open-Source-Excel-Nachbau aus der ArtCraft-Suite, getestet mit 0.8.0. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
|
Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Server von GridCraft. GridCraft ist der Open-Source-Excel-Nachbau aus der ArtCraft-Suite, getestet mit 0.8.0. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
|
||||||
|
|
||||||
## Voraussetzungen
|
## Voraussetzungen
|
||||||
|
|
||||||
- Claude Desktop (die App)
|
- Claude Desktop (die App)
|
||||||
- **GridCraft** über den ArtCraft-Launcher (`C:\Program Files\GridCraft\gridcraft-cli.exe`)
|
- **GridCraft** über den ArtCraft-Launcher (`C:\Program Files\GridCraft\gridcraft-cli.exe`)
|
||||||
- Die Erweiterung `gridcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))
|
- 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.
|
**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
|
## Installation
|
||||||
|
|
||||||
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
|
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.1.0/gridcraft-mcp-v0.1.0.mcpb) laden.
|
1. `gridcraft-mcp-v0.2.0.mcpb` und `gridcraft-mcp-v0.2.0.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).
|
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
|
||||||
3. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
3. Unter Einstellungen → Erweiterungen prüfen, dass **GridCraft for Claude** eingeschaltet ist.
|
||||||
4. Claude komplett beenden (auch Taskleiste) und neu starten.
|
4. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
||||||
|
5. Claude komplett beenden (auch Taskleiste) und neu starten.
|
||||||
|
|
||||||
**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.
|
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.
|
||||||
|
|
||||||
|
**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.
|
||||||
|
|
||||||
## Enthaltene Software
|
## Enthaltene Software
|
||||||
|
|
||||||
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/`.
|
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
|
## Im Test geprüft
|
||||||
|
|
||||||
Formeln, Tabellen, Zahlenformate und der PDF-Export. Beim Öffnen und Speichern einer bestehenden `.xlsx` blieben erhalten: verbundene Zellen, Kommentare, bedingte Formatierung, Datenüberprüfung, Namen, blattübergreifende Formeln, Fixierung, A4 quer und die Kopfzeile.
|
Formeln, Tabellen, Zahlenformate und der PDF-Export. Beim Öffnen und Speichern einer bestehenden `.xlsx` blieben erhalten: verbundene Zellen, Kommentare, bedingte Formatierung, Datenüberprüfung, Namen, blattübergreifende Formeln, Fixierung, A4 quer und die Kopfzeile.
|
||||||
|
|
||||||
## Bekannte Grenzen
|
## Bekannte Grenzen
|
||||||
|
|
||||||
@@ -39,35 +42,35 @@ Kurzfassung, die Einzelheiten stehen in [SKILL.md](SKILL.md):
|
|||||||
|
|
||||||
- Formeln nur englisch und mit Komma als Trenner.
|
- Formeln nur englisch und mit Komma als Trenner.
|
||||||
- Deutsche Zahlen und Datumsangaben als Text werden nicht erkannt und rechnen nicht mit.
|
- Deutsche Zahlen und Datumsangaben als Text werden nicht erkannt und rechnen nicht mit.
|
||||||
- Diagramme nur aus einem zusammenhängenden Bereich.
|
- Diagramme nur aus einem zusammenhängenden Bereich.
|
||||||
- CSV-Export ist komma-getrennt und schreibt das Anzeigeformat.
|
- CSV-Export ist komma-getrennt und schreibt das Anzeigeformat.
|
||||||
- Keine Makros.
|
- Keine Makros.
|
||||||
|
|
||||||
## Test
|
## 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: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
||||||
|
|
||||||
## Stolpersteine
|
## Stolpersteine
|
||||||
|
|
||||||
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
||||||
- Formeln mit deutschen Namen ergeben `#NAME?` – englische Funktionsnamen verlangen.
|
- Formeln mit deutschen Namen ergeben `#NAME?` – englische Funktionsnamen verlangen.
|
||||||
|
|
||||||
## Deinstallation/Update
|
## Deinstallation/Update
|
||||||
|
|
||||||
Deinstallation: Einstellungen → Erweiterungen → entfernen; Skill in der Skill-Liste löschen.
|
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.
|
Update: neue `.mcpb` und Skill-ZIP installieren, bestehende Version ersetzen lassen, Claude neu starten.
|
||||||
|
|
||||||
## Alternative: manuell (für Entwickler)
|
## 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 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`
|
- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
|
||||||
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\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`).
|
GridCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\GridCraft\gridcraft-cli.exe`).
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
@@ -86,6 +89,6 @@ Auffinden der EXE:
|
|||||||
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
|
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue
|
||||||
```
|
```
|
||||||
|
|
||||||
## Änderungen
|
## Änderungen
|
||||||
|
|
||||||
[CHANGELOG.md](CHANGELOG.md)
|
[CHANGELOG.md](CHANGELOG.md)
|
||||||
@@ -9,9 +9,9 @@ GridCraft ist eine Open-Source-Tabellenkalkulation (Rust), die Excel-Parität an
|
|||||||
|
|
||||||
## Voraussetzung
|
## Voraussetzung
|
||||||
|
|
||||||
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.
|
Die Werkzeuge heißen `write_range`, `read_range`, `execute_command` … mit einem Präfix, der vom Client und vom Namen der Erweiterung abhängt (z. B. `mcp__…__GridCraft_for_Claude__write_range`). Sind sie zurückgestellt, per ToolSearch nach dem Werkzeugnamen ohne Präfix suchen (z. B. `write_range`) und alle benötigten in einem Aufruf laden. Fehlen sie, dem Nutzer sagen, dass der Server nicht läuft, statt auf etwas anderes auszuweichen.
|
||||||
|
|
||||||
**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.
|
**Standardweg:** GridCraft aus dem ArtCraft-Launcher und die Claude-Desktop-Erweiterung „GridCraft for 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.
|
**Alternative (Entwickler):** Eintrag `gridcraft` in `claude_desktop_config.json`; die App kann ihn beim Speichern eigener Einstellungen überschreiben.
|
||||||
|
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
{
|
{
|
||||||
"manifest_version": "0.3",
|
"manifest_version": "0.3",
|
||||||
"name": "gridcraft-mcp",
|
"name": "gridcraft-mcp",
|
||||||
"display_name": "GridCraft für Claude",
|
"display_name": "GridCraft for Claude",
|
||||||
"version": "0.1.0",
|
"version": "0.2.0",
|
||||||
"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.",
|
"description": "Excel-Arbeitsmappen (.xlsx, .csv) erstellen und bearbeiten. Getestet mit GridCraft 0.8.0. Benötigt GridCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\GridCraft\\. Ohne Ordnersperre – GridCraft kann alle Dateien lesen und schreiben, auf die der Benutzer Zugriff hat.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Dominic Gundel"
|
"name": "Dominic Gundel"
|
||||||
},
|
},
|
||||||
@@ -32,7 +32,7 @@
|
|||||||
"tools": [
|
"tools": [
|
||||||
{
|
{
|
||||||
"name": "execute_command",
|
"name": "execute_command",
|
||||||
"description": "Run ANY GridCraft command by id with JSON params — every ribbon/menu action is a command. Find ids and parameter docs with list_commands. Examples: {\"command\":\"cell.set\",\"params\":{\"cell\":\"B2\",\"input\":\"=SUM(A1:A9)\"}}; {"
|
"description": "Run ANY GridCraft command by id with JSON params — every ribbon/menu action is a command. Find ids and parameter docs with list_commands. Examples: {\"command\":\"cell.set\",\"params\":{\"cell\":\"B2\",\"input\":\"=SUM(A1:A9)\"}}; {"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "list_commands",
|
"name": "list_commands",
|
||||||
@@ -80,7 +80,7 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "sort_range",
|
"name": "sort_range",
|
||||||
"description": "Sort a range by one or more columns. keys: [{\"column\":\"B\",\"order\":\"desc\"}, …] or just [\"B\"]. Without `range` the current region around the selection is sorted; header detection follows Excel unless `header` is given."
|
"description": "Sort a range by one or more columns. keys: [{\"column\":\"B\",\"order\":\"desc\"}, …] or just [\"B\"]. Without `range` the current region around the selection is sorted; header detection follows Excel unless `header` is given."
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "filter",
|
"name": "filter",
|
||||||
|
|||||||
@@ -1,5 +1,11 @@
|
|||||||
# Changelog – wordcraft-mcp
|
# Changelog – wordcraft-mcp
|
||||||
|
|
||||||
|
## 0.2.0 (2026-10-19)
|
||||||
|
|
||||||
|
- Erweiterung (`.mcpb`) als Standardweg; `display_name` ohne Umlaut („WordCraft for Claude“, Werkzeug-Präfix jetzt `…_for_Claude`).
|
||||||
|
- Allgemeine Werkzeugnamen im Skill (Präfix hängt vom Client und vom Erweiterungsnamen ab).
|
||||||
|
- Doku: ArtCraft-Voraussetzung und „Erweiterung einschalten“; UTF-8-Fix in Manifest und README.
|
||||||
|
|
||||||
## 0.1.0 (2026-10-19)
|
## 0.1.0 (2026-10-19)
|
||||||
|
|
||||||
- Erste Version: Skill und Claude-Desktop-Erweiterung (`.mcpb`) für WordCraft aus dem ArtCraft-Launcher.
|
- Erste Version: Skill und Claude-Desktop-Erweiterung (`.mcpb`) für WordCraft aus dem ArtCraft-Launcher.
|
||||||
|
|||||||
@@ -4,26 +4,29 @@
|
|||||||
|
|
||||||
## Zweck
|
## 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 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).
|
||||||
|
|
||||||
## Voraussetzungen
|
## Voraussetzungen
|
||||||
|
|
||||||
- Claude Desktop (die App)
|
- Claude Desktop (die App)
|
||||||
- **WordCraft** über den ArtCraft-Launcher (`C:\Program Files\WordCraft\wordcraft-cli.exe`)
|
- **WordCraft** über den ArtCraft-Launcher (`C:\Program Files\WordCraft\wordcraft-cli.exe`)
|
||||||
- Die Erweiterung `wordcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))
|
- 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.
|
Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
|
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.1.0/wordcraft-mcp-v0.1.0.mcpb) laden.
|
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.
|
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“**.
|
3. Unter Einstellungen → Erweiterungen prüfen, dass **WordCraft for Claude** eingeschaltet ist.
|
||||||
4. Claude komplett beenden (auch Taskleiste) und neu starten.
|
4. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
||||||
|
5. Claude komplett beenden (auch Taskleiste) und neu starten.
|
||||||
|
|
||||||
**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 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.
|
||||||
|
|
||||||
|
**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.
|
||||||
|
|
||||||
## Enthaltene Software
|
## Enthaltene Software
|
||||||
|
|
||||||
@@ -31,29 +34,29 @@ Die Erweiterung steuert [WordCraft](https://github.com/storytold/wordcraft) (MIT
|
|||||||
|
|
||||||
## Test
|
## Test
|
||||||
|
|
||||||
Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“
|
Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“
|
||||||
|
|
||||||
Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
|
||||||
|
|
||||||
## Stolpersteine
|
## Stolpersteine
|
||||||
|
|
||||||
- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft für Claude → Einstellungen prüfen.
|
- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen prüfen.
|
||||||
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
||||||
|
|
||||||
## Deinstallation/Update
|
## Deinstallation/Update
|
||||||
|
|
||||||
Deinstallation: Einstellungen → Erweiterungen → entfernen; Skill in der Skill-Liste löschen.
|
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.
|
Update: neue `.mcpb` und Skill-ZIP installieren, bestehende Version ersetzen lassen, Claude neu starten.
|
||||||
|
|
||||||
## Alternative: manuell (für Entwickler)
|
## 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 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`
|
- 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` (der Suffix `pzs8sxrjxfjjc` ist der Herausgeber-Hash und 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.
|
WordCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\WordCraft\wordcraft-cli.exe`). Der Schreibordner muss vorher existieren.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
@@ -77,6 +80,6 @@ Auffinden der EXE:
|
|||||||
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue
|
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue
|
||||||
```
|
```
|
||||||
|
|
||||||
## Änderungen
|
## Änderungen
|
||||||
|
|
||||||
[CHANGELOG.md](CHANGELOG.md)
|
[CHANGELOG.md](CHANGELOG.md)
|
||||||
@@ -9,9 +9,9 @@ WordCraft ist ein Open-Source-Textverarbeitungsprogramm (Rust), das Word-Paritä
|
|||||||
|
|
||||||
## Voraussetzung
|
## Voraussetzung
|
||||||
|
|
||||||
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.
|
Die Werkzeuge heißen `list_commands`, `execute`, `render_page` … mit einem Präfix, der vom Client und vom Namen der Erweiterung abhängt (z. B. `mcp__…__WordCraft_for_Claude__list_commands`). Sind sie zurückgestellt, per ToolSearch nach dem Werkzeugnamen ohne Präfix suchen (z. B. `list_commands`) und alle benötigten in einem Aufruf laden. Fehlen sie auch dann, dem Nutzer den Grund nennen statt auszuweichen.
|
||||||
|
|
||||||
**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.
|
**Standardweg:** WordCraft aus dem ArtCraft-Launcher und die Claude-Desktop-Erweiterung „WordCraft for 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.
|
**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.
|
||||||
|
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
{
|
{
|
||||||
"manifest_version": "0.3",
|
"manifest_version": "0.3",
|
||||||
"name": "wordcraft-mcp",
|
"name": "wordcraft-mcp",
|
||||||
"display_name": "WordCraft für Claude",
|
"display_name": "WordCraft for Claude",
|
||||||
"version": "0.1.0",
|
"version": "0.2.0",
|
||||||
"description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0. Erfordert WordCraft aus dem ArtCraft-Launcher.",
|
"description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0. Benötigt WordCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\WordCraft\\.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Dominic Gundel"
|
"name": "Dominic Gundel"
|
||||||
},
|
},
|
||||||
@@ -54,7 +54,7 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "open_document",
|
"name": "open_document",
|
||||||
"description": "Open a .docx, .doc, .odt, .rtf, .md, .tex, .html, .txt or .json file, or any other text file (.m3u, .log, .ini…) as plain text."
|
"description": "Open a .docx, .doc, .odt, .rtf, .md, .tex, .html, .txt or .json file, or any other text file (.m3u, .log, .ini…) as plain text."
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "save_document",
|
"name": "save_document",
|
||||||
|
|||||||
Reference in new issue
Block a user