Office-Dokumentverarbeitungs-MCP-Server

Ein MCP-Server (Model Context Protocol) für die Office-Dokumentverarbeitung, der die Erstellung und Bearbeitung von Word-, Excel- und PowerPoint-Dokumenten innerhalb von MCP-Clients ermöglicht, ohne die KI-Assistenten-Umgebung zu verlassen.

Überblick

Office-Editor-MCP implementiert den Model Context Protocol-Standard, um Office-Dokumentoperationen als Tools und Ressourcen bereitzustellen. Er dient als Brücke zwischen KI-Assistenten und Microsoft-Office-Dokumenten und ermöglicht es Ihnen, verschiedene Office-Dokumente über KI-Assistenten zu erstellen, zu bearbeiten, zu formatieren und zu analysieren.

Related MCP server: word-doc-mcp

Funktionen

Word-Dokumentoperationen

Dokumentverwaltung

• Neue Word-Dokumente mit Metadaten erstellen (Titel, Autor usw.)

• Textinhalte extrahieren und Dokumentstruktur analysieren

• Dokumenteigenschaften und Statistiken anzeigen

• Verfügbare Dokumente in einem Verzeichnis auflisten

• Dokumentkopien erstellen

Inhaltserstellung

• Überschriften mit verschiedenen Ebenen hinzufügen

• Absätze mit optionaler Formatierung einfügen

• Tabellen mit benutzerdefinierten Daten erstellen

• Bilder mit proportionaler Skalierung hinzufügen

• Seitenumbrüche einfügen

Textformatierung

• Bestimmte Textabschnitte formatieren (fett, kursiv, unterstrichen)

• Textfarbe und Schrifteigenschaften ändern

• Benutzerdefinierte Stile auf Textelemente anwenden

• Text im gesamten Dokument suchen und ersetzen

Excel-Operationen

Arbeitsmappenverwaltung

• Neue Excel-Arbeitsmappen erstellen

• Vorhandene Excel-Dateien öffnen

• Arbeitsblätter hinzufügen/löschen/umbenennen

Datenverarbeitung

• Zellinhalte lesen und schreiben

• Zeilen und Spalten einfügen/löschen

• Daten sortieren und filtern

• Formeln und Funktionen anwenden

PowerPoint-Operationen

Präsentationsverwaltung

• Neue PowerPoint-Präsentationen erstellen

• Folien hinzufügen/löschen/neu anordnen

• Folienthemen und Hintergründe festlegen

Inhaltsbearbeitung

• Text- und Grafikelemente hinzufügen

• Tabellen und Diagramme einfügen

• Animationen und Übergänge hinzufügen

Erweiterte Funktionen

• OCR-Erkennung (Text aus Bildern extrahieren)

• Dokumentvergleich (Unterschiede zwischen Dokumenten vergleichen)

• Dokumentübersetzung

• Dokumentverschlüsselung und -entschlüsselung

• Tabellendaten-Import/-Export (Datenbankinteraktion)

Installationsanleitung

Voraussetzungen

• Python 3.10 oder höher

• pip-Paketmanager

• Microsoft Office wird nur für Windows-COM-Funktionen wie PDF-Export, Animationen, Übergänge und ältere Office-Formate benötigt

• Tesseract OCR ist bei Verwendung von ocr_recognize_text erforderlich

Grundinstallation

# Clone the repository
git clone https://github.com/theWDY/office-editor-mcp.git
cd office-editor-mcp

# Install dependencies
pip install -r requirements.txt

Das Repository stellt vier unabhängige MCP-Server bereit: word_server.py, excel_server.py, powerpoint_server.py und general_server.py. Konfigurieren Sie nur die Server, die Sie benötigen. Die eingecheckte .cursor/mcp.json enthält ein vollständiges Beispiel mit vier Servern.

Konfiguration

Konfiguration in Cursor

Methode 1: UI-Konfiguration

1. Cursor öffnen

2. Zu Einstellungen > Funktionen > MCP gehen

3. Auf "+ Neuen MCP-Server hinzufügen" klicken

4. Die Konfigurationsinformationen ausfüllen:

   • Name: Office Assistant (nach Wunsch anpassen)

   • Typ: stdio auswählen

   • Befehl: Den vollständigen Pfad zum Ausführen des Servers eingeben, zum Beispiel:

     python /path/to/office-editor-mcp/word_server.py

     Hinweis: Ersetzen Sie dies durch Ihren tatsächlichen Dateipfad

Methode 2: JSON-Konfigurationsdatei (Empfohlen)

1. Erstellen Sie einen .cursor-Ordner im Projektverzeichnis (falls er nicht existiert)

2. Erstellen Sie eine mcp.json-Datei in diesem Ordner mit folgendem Inhalt:

{
  "mcpServers": {
    "office-assistant": {
      "command": "python",
      "args": ["/path/to/office-editor-mcp/word_server.py"],
      "env": {"OFFICE_EDIT_PATH": "/path/to/output"}
    }
  }
}

Konfiguration in Claude für Desktop

1. Bearbeiten Sie die Claude-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "office-document-server": {
      "command": "python",
      "args": [
        "/path/to/office-editor-mcp/word_server.py"
      ]
    }
  }
}

3. Starten Sie Claude neu, um die Konfiguration anzuwenden.

Alle Pfade, die von general_server.py verarbeitet werden, müssen innerhalb von OFFICE_EDIT_PATH bleiben. Verschiebe- und Löschoperationen sind deaktiviert, sofern OFFICE_ALLOW_DESTRUCTIVE=true nicht explizit konfiguriert ist.

Neue verschlüsselte Dateien verwenden einen versionierten Fernet-Container mit einem zufälligen Salt und Scrypt-Passwortableitung. Vorhandene verschlüsselte Dateien bleiben lesbar und können zur Aktualisierung erneut verschlüsselt werden. Batch-Operationen sind auf 100 Dateien und 16 Worker pro Anfrage begrenzt.

Verwendungsbeispiele

Nach der Konfiguration können Sie Ihrem KI-Assistenten Befehle erteilen wie:

Word-Dokumentoperationen

• "Erstelle ein neues Dokument namens 'quarterly_report.docx' mit einer Titelseite"

• "Füge dem Dokument eine Überschrift und drei Absätze hinzu"

• "Füge eine 4x4-Tabelle mit Verkaufsdaten ein"

• "Mache das Wort 'wichtig' in Absatz 2 fett und rot"

• "Suche und ersetze alle Vorkommen von 'alter Begriff' durch 'neuer Begriff'"

Excel-Operationen

• "Erstelle eine neue Excel-Arbeitsmappe namens 'financial_analysis.xlsx'"

• "Füge 'Quartalsumsatz' als Titel in Zelle A1 ein"

• "Erstelle eine Tabelle mit Abteilungsverkaufsdaten und berechne die Summe"

• "Erstelle ein Balkendiagramm für die Verkaufsdaten"

• "Sortiere die Daten in Spalte B in absteigender Reihenfolge"

PowerPoint-Operationen

• "Erstelle eine Präsentation namens 'project_presentation.pptx'"

• "Füge eine neue Folie mit dem Titel 'Projektübersicht' hinzu"

• "Füge das Firmenlogo auf Folie 2 ein"

• "Füge dem Titel eine Einflug-Animation hinzu"

API-Referenz

Word-Dokumentoperationen

# Document Creation and Properties
create_document(filename, title=None, author=None)
get_document_info(filename)
get_document_text(filename)
get_document_outline(filename)
list_available_documents(directory=".")
copy_document(source_filename, destination_filename=None)

# Content Addition
add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
add_picture(filename, image_path, width=None)
add_page_break(filename)

# Text Formatting
format_text(filename, paragraph_index, start_pos, end_pos, bold=None, 
            italic=None, underline=None, color=None, font_size=None, font_name=None)
search_and_replace(filename, find_text, replace_text)
delete_paragraph(filename, paragraph_index)
create_custom_style(filename, style_name, bold=None, italic=None, 
                    font_size=None, font_name=None, color=None, base_style=None)

Excel-Operationen

# Workbook Operations
create_workbook(filename)
open_workbook(filename)
save_workbook(filename, new_filename=None)
add_worksheet(filename, sheet_name=None)
list_worksheets(filename)

# Cell Operations
read_cell(filename, sheet_name, cell_reference)
write_cell(filename, sheet_name, cell_reference, value)
format_cell(filename, sheet_name, cell_reference, **format_args)

PowerPoint-Operationen

# Presentation Operations
create_presentation(filename)
open_presentation(filename)
save_presentation(filename, new_filename=None)
add_slide(filename, layout=None)

Fehlerbehebung

Häufige Probleme

1. Fehlende Stile

   • Einige Dokumente verfügen möglicherweise nicht über die erforderlichen Stile für Überschriften- und Tabellenoperationen

   • Der Server versucht, fehlende Stile zu erstellen oder direkte Formatierung zu verwenden

   • Verwenden Sie für beste Ergebnisse Vorlagen mit Standard-Office-Stilen

2. Berechtigungsprobleme

   • Stellen Sie sicher, dass der Server Lese-/Schreibberechtigung für Dokumentpfade hat

   • Verwenden Sie die Funktion copy_document, um bearbeitbare Kopien gesperrter Dokumente zu erstellen

   • Überprüfen Sie Dateibesitz und -berechtigungen, wenn Operationen fehlschlagen

3. Probleme beim Einfügen von Bildern

   • Verwenden Sie absolute Pfade für Bilddateien

   • Überprüfen Sie die Bildformatkompatibilität (JPEG, PNG empfohlen)

   • Überprüfen Sie Bilddateigröße und -berechtigungen

Debugging

Aktivieren Sie die detaillierte Protokollierung durch Setzen der Umgebungsvariable:

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

Implementierungsfortschritt

• ✅ MCP-Server-Grundgerüst erstellen

• ✅ Erfolgreiche Integration mit KI-Assistenten

• ✅ Grundlegende Word-Dokumentoperationen

• ✅ Grundlegende Excel-Arbeitsmappenoperationen

• ✅ Grundlegende PowerPoint-Präsentationsoperationen

• ✅ Erweiterte Funktionen verbessern

• ✅ Leistungsoptimierung

• ✅ Plattformübergreifende Kompatibilitätstests

Mitwirken

Beiträge sind willkommen! Reichen Sie gerne einen Pull Request ein.

1. Repository forken

2. Erstellen Sie Ihren Feature-Branch (git checkout -b feature/amazing-feature)

3. Committen Sie Ihre Änderungen (git commit -m 'Add some amazing feature')

4. Pushen Sie den Branch (git push origin feature/amazing-feature)

5. Öffnen Sie einen Pull Request

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.

Danksagungen

• Model Context Protocol für die Protokollspezifikation

• python-docx für die Word-Dokumentverarbeitung

• openpyxl für die Excel-Verarbeitung

• python-pptx für die PowerPoint-Verarbeitung

Hinweis: Dieser Server interagiert mit Dokumentdateien auf Ihrem System. Stellen Sie immer sicher, dass angeforderte Operationen angemessen sind, bevor Sie sie in KI-Assistenten oder anderen MCP-Clients bestätigen.