Add pdfcraft-mcp, figcraft-mcp and vectorcraft-mcp 0.1.0.
This commit is contained in:
Dominic Gundel committed
1 parent
694de7d1d7
commit
ad0ea86adc
43 files changed
+1962
-31
No files matched your search
+68
-6
@@ -1,4 +1,4 @@
|
||||
# Cursor: WordCraft und GridCraft
|
||||
# Cursor: Craft-Werkzeuge
|
||||
|
||||
Kurzfassung in der [Wurzel-README](../README.md). Für Claude Desktop: [INSTALLATION.md](INSTALLATION.md).
|
||||
|
||||
@@ -6,7 +6,7 @@ Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine
|
||||
|
||||
## Voraussetzung
|
||||
|
||||
1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin WordCraft bzw. GridCraft (Standardpfad `C:\Program Files\…`).
|
||||
1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die jeweilige App (Standardpfad `C:\Program Files\…\<app>-cli.exe`, nicht auf PATH). FigCraft steht im Katalog seit Launcher 0.4.1.
|
||||
2. Cursor Desktop.
|
||||
|
||||
## Plugin installieren (empfohlen)
|
||||
@@ -16,7 +16,9 @@ Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine
|
||||
3. **Developer: Reload Window**.
|
||||
4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind.
|
||||
|
||||
WordCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`.
|
||||
WordCraft, PdfCraft, FigCraft und VectorCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`. Der Schreib-Ordner muss im Lese-Ordner liegen (PdfCraft und VectorCraft lehnen sonst das erneute Öffnen ab; bei FigCraft ist die Lage egal, der Standard bleibt).
|
||||
|
||||
PdfCraft startet mit `--compact` (17 Kernwerkzeuge plus `tool_search`/`tool_call`). VectorCraft immer mit beiden Ordner-Argumenten starten, sonst versucht der Server zuerst `127.0.0.1:7979`. FigCraft ohne `--attach`.
|
||||
|
||||
## Alternativ: nur MCP + Skill
|
||||
|
||||
@@ -54,21 +56,81 @@ GridCraft:
|
||||
}
|
||||
```
|
||||
|
||||
PdfCraft (`--compact` nicht weglassen):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"pdfcraft": {
|
||||
"command": "C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe",
|
||||
"args": [
|
||||
"mcp",
|
||||
"--compact",
|
||||
"--automation-read-root", "${userHome}/Documents",
|
||||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
FigCraft (kein `--attach`):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"figcraft": {
|
||||
"command": "C:\\Program Files\\FigCraft\\figcraft-cli.exe",
|
||||
"args": [
|
||||
"mcp",
|
||||
"--automation-read-root", "${userHome}/Documents",
|
||||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
VectorCraft (Ordner-Argumente nicht weglassen):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"vectorcraft": {
|
||||
"command": "C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe",
|
||||
"args": [
|
||||
"mcp",
|
||||
"--automation-read-root", "${userHome}/Documents",
|
||||
"--automation-write-root", "${userHome}/Documents/Claude"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Unterstützte Variablen in `mcp.json`: `${userHome}`, `${env:NAME}`, `${workspaceFolder}`, `${pathSeparator}` (siehe Cursor-MCP-Doku). In Plugin-`mcp.json` zusätzlich Plugin-Variablen (`${READ_ROOT}`, …) und `${CURSOR_PLUGIN_ROOT}` (hier unnötig, keine gebündelte EXE).
|
||||
|
||||
**1-Klick-Deeplink:** `config` ist nur das Transport-Objekt (`{command, args}`), der Servername steht in `name=`. Pfade mit Schrägstrich (`C:/Program Files/...`). Ein Wrapper `{ servername: {command…} }` im `config` führt in Cursor zu leerem `command`.
|
||||
|
||||
## Werkzeug-Grenze
|
||||
|
||||
Die [MCP-Doku](https://cursor.com/docs/mcp) nennt keine feste Höchstzahl. Die [IDE-Release-Notes](https://cursor.com/docs/release-notes/ide) sagen, dass Agenten bei vielen MCP-Werkzeugen nicht mehr abbrechen, sondern die an das Modell gesendete Menge kappen. Die zuletzt von Cursor benannte Grenze lag bei **80** Werkzeugen, angehoben von 40 in Cursor 1.5 (Team-Antwort im [Forum](https://forum.cursor.com/t/cursor-v1-5-release-discussions/131103), August 2025).
|
||||
|
||||
PdfCraft ohne `--compact` liefert 171 Werkzeuge mit etwa 176 KB Beschreibung und liegt über dieser Grenze. Das Plugin übergibt deshalb `--compact`.
|
||||
|
||||
## Test
|
||||
|
||||
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. GridCraft. Kleines Testdokument im Schreib-Ordner anlegen.
|
||||
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. die andere App. PdfCraft: Test-PDF schwärzen und `doc_audit_redactions`. FigCraft: kleine HMI-Maske als PNG. VectorCraft: Typenschild 100×50 mm als DXF, Maße im CAD prüfen.
|
||||
|
||||
## Probleme
|
||||
|
||||
| Problem | Lösung |
|
||||
|---|---|
|
||||
| Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? |
|
||||
| WordCraft path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). |
|
||||
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft` / `gridcraft`) registriert. |
|
||||
| path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). Er muss im Lese-Ordner liegen. |
|
||||
| VectorCraft spricht Port 7979 an | Ordner-Argumente fehlen. Plugin-`mcp.json` prüfen. |
|
||||
| Zu viele Werkzeuge / PdfCraft wirkt abgeschnitten | `--compact` muss in den Args stehen. |
|
||||
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft`, `gridcraft`, `pdfcraft`, `figcraft`, `vectorcraft`) registriert. |
|
||||
|
||||
## Datenschutz
|
||||
|
||||
|
||||
Reference in new issue
Block a user