4.4 KiB
gridcraft-mcp
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.
Voraussetzungen
- Claude Desktop (die App)
- GridCraft über den ArtCraft-Launcher (
C:\Program Files\GridCraft\gridcraft-cli.exe) - Die Erweiterung
gridcraft-mcp-….mcpbund dieses Skill-ZIP (siehe 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.
Installation
Schritt-für-Schritt: docs/INSTALLATION.md. Kurz:
gridcraft-mcp-v0.2.0.mcpbundgridcraft-mcp-v0.2.0.zipaus dem Release laden.- Die
.mcpbdoppelklicken (oder über Einstellungen → Erweiterungen installieren). - Unter Einstellungen → Erweiterungen prüfen, dass GridCraft for Claude eingeschaltet ist.
- Skill-ZIP in Claude hochladen: „+“ → „Skill erstellen“ → „Skill hochladen“.
- Claude komplett beenden (auch Taskleiste) und neu starten.
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
Die Erweiterung steuert 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
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
Kurzfassung, die Einzelheiten stehen in SKILL.md:
- Formeln nur englisch und mit Komma als Trenner.
- Deutsche Zahlen und Datumsangaben als Text werden nicht erkannt und rechnen nicht mit.
- Diagramme nur aus einem zusammenhängenden Bereich.
- CSV-Export ist komma-getrennt und schreibt das Anzeigeformat.
- Keine Makros.
Test
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.
Stolpersteine
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
- Formeln mit deutschen Namen ergeben
#NAME?– englische Funktionsnamen verlangen.
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.
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.
- 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).
{
"mcpServers": {
"gridcraft": {
"command": "C:\\Program Files\\GridCraft\\gridcraft-cli.exe",
"args": ["mcp"]
}
}
}
Auffinden der EXE:
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "gridcraft-cli.exe" -ErrorAction SilentlyContinue