Model Context Protocol

MCP

Fünf lokale Tools für Projektanlage, Dokumentprüfung, visuelle Seiteninspektion und PDF-Ausgabe.

Server starten

satzstrom mcp

Erfolgreiche Antworten enthalten nur structuredContentund angeforderte Bilder. Fehler erscheinen als kurzer Textblock.

Einrichtung

Registriere Satzstrom als lokalen stdio-Server im MCP-Client.

MCP-Client-Konfiguration

{  "command": "satzstrom",  "args": ["mcp"]}

init

Initialisiert ein neues Satzstrom-Dokumentprojekt.

Signatur

init({ directoryPath })

Parameter
Name	Typ	Pflicht	Beschreibung
`directoryPath`	`string`	Ja	Pfad für den neuen Projektordner.

structuredContent

type InitOutput = {  /** Absoluter Pfad zum erstellten Dokument. */  documentPath: string;};

Beispiel

{ "directoryPath": "documents/new-project" }

add

Erzeugt genau eine Satzstrom-Dokumentdatei in einem bestehenden TypeScript-Projekt.

Signatur

add({ documentPath })

Parameter
Name	Typ	Pflicht	Beschreibung
`documentPath`	`string`	Ja	Pfad für die neue .tsx-Datei mit vorhandenem Elternordner.

structuredContent

type AddOutput = {  /** Absoluter Pfad zum erstellten Dokument. */  documentPath: string;};

Beispiel

{ "documentPath": "documents/report.tsx" }

check

Prüft ein Dokument und liefert ausschließlich Seitenzahl und konkrete Layoutprobleme.

Signatur

check({ documentPath, args?, dataPath? })

Parameter
Name	Typ	Pflicht	Beschreibung
`documentPath`	`string`	Ja	Exakte .tsx-Dokumentdatei.
`args`	`object`	Nein	Direkte Komponenten-Props nach Validierung durch das exportierte Zod-Objektschema; alternativ zu dataPath.
`dataPath`	`string`	Nein	JSON-Datei mit direkten Komponenten-Props; alternativ zu args.

structuredContent

type CheckOutput = {  /** Seitenzahl des Dokuments. */  pageCount: number;  /** Konkrete Layoutprobleme in Dokumentreihenfolge. */  issues: Array<{    message: string;    /** Einsbasierte Seite, falls bekannt. */    pageNumber?: number;    source?: { filePath: string; line: number; column: number };  }>;};

Beispiel

{  "documentPath": "documents/report.tsx",  "dataPath": "documents/report.json"}

inspect

Liefert ausgewählte Dokumentseiten direkt als PNG-Bilder, sichtbaren Text oder beides.

Signatur

inspect({ documentPath, args?, dataPath?, startPage?, endPage?, images?, text? })

Parameter
Name	Typ	Pflicht	Beschreibung
`documentPath`	`string`	Ja	Exakte .tsx-Dokumentdatei.
`args`	`object`	Nein	Direkte Komponenten-Props nach Validierung durch das exportierte Zod-Objektschema; alternativ zu dataPath.
`dataPath`	`string`	Nein	JSON-Datei mit direkten Komponenten-Props; alternativ zu args.
`startPage`	`integer`	Nein	Erste Seite des inklusiven, einsbasierten Bereichs; 0 mit endPage -1 wählt alle.
`endPage`	`integer`	Nein	Letzte Seite des inklusiven, einsbasierten Bereichs; -1 mit startPage 0 wählt alle.
`images`	`boolean`	Nein	Liefert jede ausgewählte Seite als image/png-Block.
`text`	`boolean`	Nein	Liefert den sichtbaren Text jeder ausgewählten Seite.

structuredContent und Bilder

type InspectOutput = {  pages: Array<{    /** Einsbasierte Seitennummer. */    pageNumber: number;    /** Sichtbarer Text, wenn angefordert. */    text?: string;  }>;};// Angeforderte PNGs folgen als image/png-Blöcke in derselben Reihenfolge.

Beispiel

{  "documentPath": "documents/report.tsx",  "startPage": 2,  "endPage": 4,  "images": true,  "text": true}

render

Setzt ein Dokument und schreibt die angegebene PDF.

Signatur

render({ documentPath, args?, dataPath?, outputPath, overwrite? })

Parameter
Name	Typ	Pflicht	Beschreibung
`documentPath`	`string`	Ja	Exakte .tsx-Dokumentdatei.
`args`	`object`	Nein	Direkte Komponenten-Props nach Validierung durch das exportierte Zod-Objektschema; alternativ zu dataPath.
`dataPath`	`string`	Nein	JSON-Datei mit direkten Komponenten-Props; alternativ zu args.
`outputPath`	`string`	Ja	Pfad zur zu erstellenden PDF.
`overwrite`	`boolean`	Nein	Ersetzt eine vorhandene PDF; standardmäßig false.

structuredContent

type RenderOutput = {  /** Absoluter Pfad zur gerenderten PDF. */  outputPath: string;};

Beispiel

{  "documentPath": "documents/report.tsx",  "outputPath": "dist/report.pdf"}

Pfade

Absolute Pfade funktionieren direkt. Relative Pfade werden gegen genau einen file-Root des aufrufenden Clients aufgelöst.