Dokumenty biurowe

Integracja z dokumentami biurowymi umożliwia Speedwave automatyczne tworzenie, inspekcję, edycję i konwersję plików Word (.docx), Excel (.xlsx), PowerPoint (.pptx) i PDF oraz generowanie wykresów bezpośrednio w katalogu projektu, bez konieczności posiadania subskrypcji chmurowych.

Architektura i silniki przetwarzania

Kontener workera mcp-office łączy sprawdzone narzędzia open-source:

Odczyt dokumentów: markitdown oraz SheetJS.
Konwersje Markdown i HTML: pandoc oraz WeasyPrint.
Silnik konwersji Office i ODF: LibreOffice w trybie headless.
Silniki dokumentów w Pythonie: python-docx, openpyxl, python-pptx oraz pypdf.
Generowanie wykresów: matplotlib.

Kontener montuje przestrzeń roboczą projektu w trybie odczytu i zapisu pod ścieżką /workspace. Nie wymaga podpinania żadnych katalogów poświadczeń.

flowchart LR
  Claude -->|"Wywołanie narzędzia"| Hub["Tool Gateway"]
  Hub -->|"HTTP"| Worker["Worker mcp-office<br/>Brak poświadczeń, brak ruchu sieciowego"]
  Worker -->|"Odczyt / Zapis"| WS["Katalog projektu<br/>/workspace:rw"]
  Worker -->|"Zapisuje do"| Out[".speedwave/office/"]

Wykaz narzędzi

Operacje na dokumentach i konwersje domyślnie tworzą nowe pliki wynikowe, chroniąc pliki źródłowe przed nadpisaniem (chyba że jawnie przekazano parametr overwrite: true):

Narzędzie	Zakres działania
`readDocument`	Odczyt tekstu i struktury z plików Word, Excel, PowerPoint, PDF i HTML do formatu Markdown.
`readPdfText`	Ekstrakcja surowej cyfrowej warstwy tekstowej z dokumentu PDF.
`pdfMetadata`	Odczyt metadanych PDF (liczba stron, autor, tytuł, flagi szyfrowania).
`markdownToPdf`	Kompilacja Markdown do formatu PDF za pomocą pandoc i WeasyPrint.
`htmlToPdf`	Renderowanie lokalnych plików HTML do PDF przez WeasyPrint.
`markdownToDocx`	Konwersja dokumentu Markdown do pliku Word (.docx).
`markdownToPptx`	Przekształcanie nagłówków Markdown w slajdy prezentacji PowerPoint.
`renderChart`	Generowanie wykresów w formacie PNG lub SVG jako osobnych plików (słupkowe, liniowe, kołowe, punktowe, warstwowe).
`createDocx`	Generowanie plików Word na podstawie ustrukturyzowanej specyfikacji.
`editDocx`	Modyfikacja akapitów, tabel i bloków tekstu w istniejącym dokumencie Word.
`createXlsx`	Tworzenie skoroszytów Excel z osadzonymi natywnymi wykresami i formułami.
`editXlsx`	Aktualizacja komórek, dodawanie arkuszy i modyfikacja formuł w plikach Excel.
`createPptx`	Tworzenie prezentacji PowerPoint z hierarchią punktów, grafikami i natywnymi wykresami.
`editPptx`	Modyfikacja treści, tytułów i kolejności slajdów.
`officeToPdf`	Eksport dokumentów pakietu Office do PDF za pośrednictwem LibreOffice w trybie headless.
`convertOffice`	Konwersja pomiędzy formatami pakietu Office/ODF według zdefiniowanej macierzy.
`mergePdf`	Łączenie wielu plików PDF w jeden dokument.
`splitPdf`	Dzielenie pliku PDF na osobne dokumenty według zakresu stron.
`rotatePdf`	Obracanie wybranych stron dokumentu PDF o 90, 180 lub 270 stopni.
`watermarkPdf`	Nakładanie jednostronicowego znaku wodnego PDF na strony dokumentu.
`fillPdfForm`	Wypełnianie pól formularzy AcroForm na podstawie słowników klucz-wartość.

Foldertwoj-projekt/
- Folder.speedwave/
  - Folderoffice/
    raport.pdf
    zestawienie.xlsx
    prezentacja.pptx

Konfiguracja

Włącz opcję Beta features w menu zasobnika systemowego, a następnie aktywuj Dokumenty biurowe na liście integracji projektu. Początkowe uruchomienie buduje lokalnie obraz kontenera z warstwami LibreOffice i Pythona.

Bezpieczeństwo i całkowita izolacja sieciowa

Worker wykonuje się w odizolowanym kontenerze bez dostępu do sieci zewnętrznej. Wszystkie operacje konwersji i generowania grafiki odbywają się całkowicie offline. Obsługa makr i aktywnych silników skryptowych wewnątrz dokumentów jest trwale wyłączona. Dodatkowe parametry bezpieczeństwa znajdziesz w rozdziale Model izolacji.