MCP DOCX Template Server

Ein portabler MCP-Server, der eine gestaltete Microsoft Word-Vorlage klont und sie mit Inhalten aus einem anderen Dokument füllt, wobei Bilder, Layout, Schriftarten, Farben und Absatzstile erhalten bleiben.

Werkzeuge

Der Server stellt drei Werkzeuge bereit:

• analyze_template — Untersucht eine .docx-Vorlage und gibt deren Absatzstruktur, Bilder, Stile und ein Inhaltsschema zurück. Schreibt außerdem einen <template>.docx.md-Deskriptor neben die Vorlage, sodass wiederholte Abfragen (z. B. durch den Prompt map_content_to_template) keine erneute Analyse benötigen.

• extract_content — Extrahiert bearbeitbare Textblöcke aus einem Inhalts-.docx.

• fill_template — Klont die Vorlage und ersetzt deren bearbeitbaren Text mithilfe einer Label-zu-Text-Zuordnung. Konvertiert das Ergebnis optional in PDF.

Related MCP server: Word MCP Server

Prompts

• map_content_to_template — Gegeben einen template_path und content_path, liest den .docx.md-Deskriptor der Vorlage (analysiert und schreibt ihn zuerst, falls er noch nicht existiert) sowie den extrahierten Inhalt und gibt eine Anweisungsnachricht zum Erstellen eines content_mapping zurück. Der Assistent wird angewiesen, den Benutzer direkt zu fragen, wenn eine Zuordnung mehrdeutig ist, und dann fill_template aufzurufen.

Installation

pip install .

Oder, für die Entwicklung mit Tests:

pip install -e ".[dev]"

Verwendung mit Claude Desktop

Fügen Sie den Server zu Ihrer Claude-Desktop-Konfiguration hinzu (claude_desktop_config.json):

{
  "mcpServers": {
    "docx-template": {
      "command": "mcp-docx-template-server"
    }
  }
}

Der Server verwendet den stdio-Transport. Nach der Konfiguration kann Claude analyze_template, extract_content und fill_template aufrufen.

Beispielablauf

1. Analysieren Sie die Vorlage:

{
  "template_path": "/path/to/SSIT_Template.docx"
}

2. Extrahieren Sie den Inhalt aus dem Quelldokument:

{
  "content_path": "/path/to/NetApp_Content.docx"
}

3. Füllen Sie die Vorlage:

{
  "template_path": "/path/to/SSIT_Template.docx",
  "content_mapping": {
    "overview": "NetApp Cutover Dependency Mapper",
    "business_challenge": "Business Challenge",
    "body_1": "Long body paragraph...",
    "solution_item_1": "Title\nBody text..."
  },
  "output_path": "/path/to/output.docx",
  "convert_to_pdf": true
}

Entwicklung

Tests ausführen:

pytest

Lizenz

MIT