@prontosite/mcp 0.12.1 → 0.13.2

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 Alle nennenswerten Änderungen am MCP-Server für ProntoSite. Der Server ist ein dünner Client um die
 ProntoSite Deploy-API; die eigentliche Logik lebt serverseitig.
 
+## 0.13.2 – 2026-10-19
+
+- Upload-Beschreibung: Bilder und PDF; PDFs mit Skripten, automatischen Aktionen, Formular-Versand oder Anhängen werden abgelehnt;
+  Office-Dokumente folgen mit dem Virenscanner (bitte als PDF exportieren).
+
+## 0.13.1 – 2026-10-19
+
+- `media_upload_begin`/`media_upload_commit`: Dokumente (PDF, DOCX, XLSX, PPTX, ODT) werden jetzt angenommen – nach derselben
+  Strukturprüfung wie im Dashboard (keine Skripte, Makros, Öffnen-Aktionen, eingebetteten Dateien). Dokumente als Download verlinken.
+
+## 0.13.0 – 2026-10-19
+
+- **Bilder hochladen und einsetzen:** `media_upload_begin` (ein Link, zwei Wege: Datei per PUT selbst hochladen – im lokalen Paket
+  einfach `path` angeben – oder Link an den Nutzer, Upload-Seite mit Kamera), `media_upload_commit` (Prüfung, Kontingent,
+  Optimierung auf dem Server → `mediaId`), `site_media_list`, `site_image_set` (Bild per Knoten-ID oder Marker tauschen, mit `alt`).
+- **Design-Sicht:** `site_preview_screenshot` liefert den Entwurf als Bild (1280/390 px), meldet horizontalen Überlauf.
+- Instructions: Bilder nie als Varianten/ZIP, Design über die CSS-Datei, nach Design-Änderungen Screenshot prüfen.
+
+## 0.12.2 – 2026-10-19
+
+- **Textarbeit ohne HTML (Übersetzen, Umformulieren):** neu `site_page_texts` (alle Texte einer Seite inkl. Menü-/Button-Texten,
+  `alt`/`title`, Seitentitel, Meta-Beschreibung), `site_page_texts_set` (alles in einem Aufruf, ein Rückgängig-Schritt, unbekannte
+  IDs → nichts geändert) und `site_page_copy` (Seite duplizieren, z. B. `index.html` → `en/index.html`, Pfade angepasst,
+  Sprachfassung verknüpft). Rechtstext-Seiten ausgenommen.
+- Instructions: Übersetzung/Textüberarbeitung je Seite über `site_page_texts` → `site_page_texts_set`, nie HTML per `site_file_put`.
+
 ## 0.12.1 – 2026-10-19
 
 - **`site_edit_text` in einem Aufruf für die ganze Website:** `scope:"all"` ersetzt alle Fundstellen auf allen Seiten sofort

package/api.mjs

@@ -397,6 +397,70 @@ export async function apiEditText(cfg, { site, find, replace, scope = null, regi
     method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) }));
 }
 
+/** GET /api/page-texts/<site>?page= – alle Texte einer Seite (Textknoten, reine Text-Links, Attribute, Titel/Beschreibung). */
+export async function apiPageTexts(cfg, { site, page } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  return asJson(await fetchImpl(`${baseUrl(cfg)}/page-texts/${encodeURIComponent(slug)}?page=${encodeURIComponent(page ?? "")}`, { headers: authHeaders(token, cfg) }));
+}
+/** POST /api/page-texts/<site> – Texte einer Seite in EINEM Aufruf setzen (ein Undo-Eintrag). 409 kommt als Objekt zurück. */
+export async function apiPageTextsSet(cfg, { site, page, texts, baseRev } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/page-texts/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ page, texts, baseRev }) }));
+}
+/** POST /api/page-copy/<site> – Seite duplizieren (z. B. index.html → en/index.html), relative Pfade angepasst. */
+export async function apiPageCopy(cfg, { site, from, to, baseRev = null } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/page-copy/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ from, to, ...(Number.isInteger(baseRev) ? { baseRev } : {}) }) }));
+}
+
+/** POST /api/media-upload/<site> – Upload-Link (15 Min., einmalig) für ein neues Bild; lokal optional gleich hochladen (path). */
+export async function apiMediaUploadBegin(cfg, { site, purpose = null, filename = null, path: localPath = null } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  const name = filename || (localPath ? path.basename(localPath) : null);
+  const out = await asJson(await fetchImpl(`${baseUrl(cfg)}/media-upload/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ purpose, filename: name }) }));
+  if (localPath) {   // lokales Paket mit Dateizugriff: Originaldatei selbst per PUT hochladen (keine Varianten, kein ZIP)
+    if (!fs.existsSync(localPath)) throw new Error(`Datei nicht gefunden: ${localPath}`);
+    const up = await fetchImpl(out.uploadUrl, { method: "PUT", headers: { "x-filename": encodeURIComponent(name || "bild") }, body: fs.readFileSync(localPath) });
+    const r = await up.json().catch(() => ({}));
+    if (!up.ok) throw new Error(r.error || `Upload fehlgeschlagen (HTTP ${up.status}).`);
+    return { ...out, uploaded: true, bytes: r.bytes, next: "Hochgeladen – jetzt media_upload_commit {uploadId}." };
+  }
+  return out;
+}
+/** POST /api/media-commit/<site> – hochgeladene Datei prüfen und als Medium ablegen → mediaId. */
+export async function apiMediaCommit(cfg, { site, uploadId } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  const res = await fetchImpl(`${baseUrl(cfg)}/media-commit/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ uploadId }) });
+  if (res.status === 409) { const b = await res.json().catch(() => ({})); if (b.pending) return { pending: true, hinweis: b.error }; throw new Error(b.error || "Konflikt (409)."); }
+  return asJson(res);
+}
+/** GET /api/media/<site> – Medien der Website (mediaId, Typ, Größe, Maße) + Kontingent. */
+export async function apiMediaList(cfg, { site } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  return asJson(await fetchImpl(`${baseUrl(cfg)}/media/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) }));
+}
+/** POST /api/image-set/<site> – Bild einer Seite tauschen (setImage, ein Undo-Schritt). */
+export async function apiImageSet(cfg, { site, page, nodeId = null, marker = null, mediaId, alt = null, baseRev = null } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/image-set/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" },
+    body: JSON.stringify({ page, mediaId, ...(nodeId ? { nodeId } : {}), ...(marker ? { marker } : {}), ...(alt != null ? { alt } : {}), ...(Number.isInteger(baseRev) ? { baseRev } : {}) }) }));
+}
+/** GET /api/preview-screenshot/<site>?page=&width= – PNG des Entwurfs (Base64 + Maße). */
+export async function apiPreviewScreenshot(cfg, { site, page = "index.html", width = 1280 } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  const res = await fetchImpl(`${baseUrl(cfg)}/preview-screenshot/${encodeURIComponent(slug)}?page=${encodeURIComponent(page)}&width=${encodeURIComponent(width)}`, { headers: authHeaders(token, cfg) });
+  if (!res.ok) return asJson(res);
+  const buf = Buffer.from(await res.arrayBuffer());
+  const h = k => res.headers.get(k);
+  return { png: buf.toString("base64"), width: Number(h("x-ps-width")), height: Number(h("x-ps-height")), fullHeight: Number(h("x-ps-full-height")),
+    truncated: h("x-ps-truncated") === "1", overflowX: Number(h("x-ps-overflow-x") || 0), ms: Number(h("x-ps-ms")), page: decodeURIComponent(h("x-ps-page") || page), bytes: buf.length };
+}
+
 /** GET/POST /api/lock/<site> – sanfte Sperre („in Bearbeitung durch …"); blockiert niemanden. action: lock|unlock|takeover. */
 export async function apiLock(cfg, { site, action = null, note = null } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);

package/index.mjs

@@ -21,7 +21,7 @@ const cfg = loadConfig();
 // es im MCP-Log/Terminal auffällt; die endgültige Auflösung (Betreuer-Token-Vorrang vs. Map) klärt sites_list.
 for (const w of (cfg.warnings || [])) process.stderr.write("[prontosite-mcp] ⚠ " + w + "\n");
 // instructions: Arbeitsweise (Weg B = Standard) – gleicher Text wie am Remote-Endpunkt.
-const server = new McpServer({ name: "prontosite", version: "0.12.1" }, { instructions: SERVER_INSTRUCTIONS });
+const server = new McpServer({ name: "prontosite", version: "0.13.2" }, { instructions: SERVER_INSTRUCTIONS });
 // Tool-Definitionen: gemeinsame Quelle mit dem Remote-Endpunkt (tools.mjs, Konzept KI-Anbindung §4.2).
 registerTools(server, { z, cfg, mode: "local" });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.12.1",
+  "version": "0.13.2",
   "description": "MCP-Server für ProntoSite – Website-Status, Export, Deploy und Veröffentlichen direkt aus einem KI-Assistenten (Claude Desktop). Dünner Client um die ProntoSite Deploy-API.",
   "type": "module",
   "bin": {

package/tools.mjs

@@ -9,7 +9,7 @@
  *                site_domain_connect nur mit Betreuer-Token (Entscheidung 9a).
  * `z` wird vom Aufrufer übergeben (dieselbe zod-Instanz wie sein MCP-SDK).
  */
-import { apiEditText, apiStatus, apiExport, apiExportFetch, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock } from "./api.mjs";
+import { apiEditText, apiPageTexts, apiPageTextsSet, apiPageCopy, apiMediaUploadBegin, apiMediaCommit, apiMediaList, apiImageSet, apiPreviewScreenshot, apiStatus, apiExport, apiExportFetch, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock } from "./api.mjs";
 
 /**
  * Arbeitsweise (MCP-`instructions` beim Initialize – lokal UND /mcp): Weg B ist der Standard (Nick 19.10.).
@@ -25,9 +25,17 @@ export const SERVER_INSTRUCTIONS = [
   "2a. Für Text-, Link- und Kontaktdaten-Änderungen (Telefonnummer, E-Mail, Adresse, Öffnungszeiten) IMMER site_edit_text mit "
     + "scope:\"all\" (bei Bedarf region:\"footer\"/\"header\") – EIN Aufruf für alle Seiten, inkl. tel:/mailto:-Links. NIE Seite für Seite per "
     + "site_file_put. Meldet die Antwort company, zusätzlich site_company_set für die Firmendaten (Impressum/Datenschutz/Kontakt).",
+  "2b. Für Übersetzungen und Textüberarbeitung: site_page_texts → Texte übersetzen/überarbeiten → site_page_texts_set, JE SEITE ein Aufruf "
+    + "(neue Sprachfassung vorher mit site_page_copy, z. B. index.html → en/index.html). NIE HTML über site_file_put umschreiben. "
+    + "Rechtstext-Seiten (Impressum/Datenschutz) sind ausgenommen.",
   "3. Veröffentlichen (site_publish, publish=true) NUR nach ausdrücklicher Bestätigung des Nutzers im Chat – bis dahin bleibt alles im Entwurf.",
   "4. Konflikt (409, conflict:true): nicht erzwingen. Erst site_status aufrufen (zeigt, wer was geändert hat), Inhalt neu holen, Änderung "
     + "neu anwenden und mit der neuen draftRev erneut senden.",
+  "5a. Bilder: Für neue Bilder media_upload_begin → Upload-Link. Wenn du Dateien lesen kannst, lade die ORIGINALDATEI selbst per HTTP PUT "
+    + "hoch (lokales Paket: path angeben); sonst gib den Link (uploadPage) an den Nutzer weiter – er lädt am Handy/PC hoch. Danach "
+    + "media_upload_commit und mit site_image_set einsetzen. Nie Varianten selbst bauen, nie ZIP für Medien.",
+  "5b. Design = CSS-Datei ändern (site_file_get/site_file_put), nicht HTML umschreiben. Nach Design- oder Bild-Änderungen "
+    + "site_preview_screenshot (1280 bzw. 390) prüfen, BEVOR du dem Nutzer antwortest.",
   "5. Jede Änderung lässt sich rückgängig machen; Rechtstexte (Impressum/Datenschutz) nicht umformulieren – sie kommen aus den Firmendaten.",
 ].join("\n");
 
@@ -128,6 +136,96 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
     async ({ site, find, replace, scope, region, attributes, pages, baseRev }) => { try { return asText(await apiEditText(cfg, { site, find, replace, scope, region, attributes, pages, baseRev })); } catch (e) { return asError(e); } }
   );
 
+  server.tool(
+    "site_page_texts",
+    "LESEND – STANDARDWEG für Übersetzung/Umformulierung: liefert ALLE Texte einer Seite ohne HTML: [{id, role, text, markdown?}] – "
+      + "Textknoten, reine Text-Links (Menüpunkte, Buttons), Attribute (alt, title, aria-label, placeholder) sowie Seitentitel (head:title) "
+      + "und Meta-Beschreibung (head:description), dazu draftRev. Danach Texte bearbeiten und mit site_page_texts_set in EINEM Aufruf "
+      + "zurückschreiben. Rechtstext-Seiten liefern 403 (ausgenommen).",
+    { site: z.string().optional().describe(SITE_DESC),
+      page: z.string().describe("Seite: Seiten-ID, Datei (z. B. 'index.html', 'en/index.html') oder Slug.") },
+    async ({ site, page }) => { try { return asText(await apiPageTexts(cfg, { site, page })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_page_texts_set",
+    "SCHREIBEND (Entwurf, nicht live) – STANDARDWEG für Übersetzung/Umformulierung: setzt Texte einer Seite in EINEM Aufruf "
+      + "(ein Rückgängig-Schritt). texts = [{id, text}] mit IDs aus site_page_texts (bei Einträgen mit markdown: markdown zurückgeben, "
+      + "dann bleiben Fett/Kursiv/Links erhalten). Struktur, Klassen und Linkziele bleiben unberührt. Unbekannte IDs → Fehler, es wird "
+      + "NICHTS geändert (keine Teilanwendung). baseRev = draftRev aus site_page_texts; bei 409 erst site_status/site_page_texts neu.",
+    { site: z.string().optional().describe(SITE_DESC),
+      page: z.string().describe("Seite (wie bei site_page_texts)."),
+      texts: z.array(z.object({ id: z.string(), text: z.string().optional(), markdown: z.string().optional() })).describe("Neue Texte je ID (nur geänderte nötig)."),
+      baseRev: z.number().int().describe("draftRev aus site_page_texts (Konfliktschutz).") },
+    async ({ site, page, texts, baseRev }) => { try { return asText(await apiPageTextsSet(cfg, { site, page, texts, baseRev })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_page_copy",
+    "SCHREIBEND (Entwurf) – neue Sprachfassung oder Variante einer Seite: dupliziert eine Seite (inkl. Dashboard-Änderungen) unter neuem "
+      + "Pfad, z. B. from='index.html', to='en/index.html'. Relative Pfade (Bilder, CSS, Links) werden angepasst; in einem Sprachordner "
+      + "setzt der Server <html lang> und verknüpft die Kopie als Sprachfassung. Danach site_page_texts → übersetzen → site_page_texts_set "
+      + "auf der Kopie. Vorhandene Dateien werden nie überschrieben; Rechtstext-Seiten werden nicht kopiert.",
+    { site: z.string().optional().describe(SITE_DESC),
+      from: z.string().describe("Quellseite (Seiten-ID, Datei oder Slug)."),
+      to: z.string().describe("Neuer Pfad der Kopie, z. B. 'en/index.html' oder 'en/kontakt/index.html'."),
+      baseRev: z.number().int().optional().describe("Optional: draftRev aus site_status (Konfliktschutz).") },
+    async ({ site, from, to, baseRev }) => { try { return asText(await apiPageCopy(cfg, { site, from, to, baseRev })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "media_upload_begin",
+    "SCHREIBEND (Schritt 1 von 2) – neues Bild oder Dokument hochladen: liefert einen UPLOAD-LINK (15 Minuten, einmalig, Größe nach "
+      + "Tarif-Kontingent; Bilder JPG/PNG/WebP/SVG und PDF – PDFs mit Skripten, Öffnen-/Ereignis-Aktionen, Formular-Versand oder "
+      + "Anhängen werden abgelehnt; Office-Dokumente folgen mit dem Virenscanner, bitte als PDF exportieren). Zwei Wege über DENSELBEN Link: (a) Du kannst Dateien lesen → Originaldatei per HTTP PUT an uploadUrl senden "
+      + (mode === "local" ? "(hier einfach path angeben, das Paket lädt selbst hoch) " : "(z. B. curl -T bild.jpg '<uploadUrl>') ")
+      + "– keine Varianten bauen, kein ZIP. (b) Sonst den Link (uploadPage) dem Nutzer geben: er öffnet ihn am Handy/PC, fotografiert oder "
+      + "wählt eine Datei. Danach media_upload_commit.",
+    { site: z.string().optional().describe(SITE_DESC),
+      purpose: z.string().optional().describe("Wofür das Bild ist (z. B. 'Titelbild Startseite') – erscheint auf der Upload-Seite nicht, hilft im Verlauf."),
+      filename: z.string().optional().describe("Gewünschter Dateiname (z. B. 'team-foto.jpg')."),
+      ...(mode === "local" ? { path: z.string().optional().describe("Lokaler Dateipfad – das Paket lädt die Datei direkt hoch.") } : {}) },
+    async ({ site, purpose, filename, path }) => { try { return asText(await apiMediaUploadBegin(cfg, { site, purpose, filename, path: mode === "local" ? path : null })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "media_upload_commit",
+    "SCHREIBEND (Schritt 2 von 2): übernimmt die hochgeladene Datei – Prüfung von Typ/Inhalt, Kontingent und Virenscan, Optimierung "
+      + "(WebP, Varianten, EXIF entfernt) – und liefert die mediaId. Antwort pending:true = der Nutzer hat noch nicht hochgeladen (kurz warten "
+      + "bzw. nachfragen). Bilder danach mit site_image_set einsetzen; Dokumente als Download verlinken (href = mediaId).",
+    { site: z.string().optional().describe(SITE_DESC), uploadId: z.string().describe("uploadId aus media_upload_begin.") },
+    async ({ site, uploadId }) => { try { return asText(await apiMediaCommit(cfg, { site, uploadId })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_media_list",
+    "LESEND: Medien der Website (mediaId, Name, Typ, Größe, Maße; Uploads und Bilder der importierten Website) und das Medien-Kontingent.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiMediaList(cfg, { site })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_image_set",
+    "SCHREIBEND (Entwurf): setzt ein Bild auf einer Seite ein (ein Rückgängig-Schritt). Ziel: nodeId des Bild-Knotens oder marker (id- bzw. "
+      + "data-ps-Wert eines Elements; dessen Bild wird getauscht). mediaId aus media_upload_commit oder site_media_list. alt = Bildbeschreibung "
+      + "(für Barrierefreiheit/SEO immer setzen). Danach site_preview_screenshot prüfen.",
+    { site: z.string().optional().describe(SITE_DESC), page: z.string().describe("Seite (ID, Datei oder Slug)."),
+      nodeId: z.string().optional(), marker: z.string().optional(), mediaId: z.string(), alt: z.string().optional(),
+      baseRev: z.number().int().optional().describe("Optional: draftRev (Konfliktschutz).") },
+    async (a) => { try { return asText(await apiImageSet(cfg, a)); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_preview_screenshot",
+    "LESEND: Bildschirmfoto des ENTWURFS einer Seite als Bild (Desktop width=1280, Smartphone width=390; max. 4000 px hoch, ohne "
+      + "JavaScript-Effekte). Nach Design- oder Bild-Änderungen prüfen, bevor du antwortest. Begrenzt (30 je Stunde, ein Lauf gleichzeitig).",
+    { site: z.string().optional().describe(SITE_DESC), page: z.string().default("index.html").describe("Seite (ID, Datei oder Slug)."),
+      width: z.union([z.literal(1280), z.literal(390)]).default(1280) },
+    async ({ site, page, width }) => {
+      try {
+        const r = await apiPreviewScreenshot(cfg, { site, page, width });
+        if (!r.png) return asText(r);
+        return { content: [{ type: "image", data: r.png, mimeType: "image/png" },
+          { type: "text", text: JSON.stringify({ page: r.page, width: r.width, height: r.height, ...(r.truncated ? { abgeschnitten: `Seite ist ${r.fullHeight} px hoch – gezeigt die oberen ${r.height} px` } : {}),
+            ...(r.overflowX ? { horizontalerUeberlauf: `Inhalt ist ${r.overflowX} px breit (Viewport ${r.width}) – die Seite scrollt seitwärts; meist ein Bild/Element ohne max-width.` } : {}), ms: r.ms }) }] };
+      } catch (e) { return asError(e); }
+    }
+  );
+
   if (mode === "local") {
     server.tool(
       "site_export",