Office-Word-MCP-Server
Ein Model Context Protocol (MCP)-Server zum Erstellen, Lesen und Bearbeiten von Microsoft Word-Dokumenten. Dieser Server ermöglicht KI-Assistenten die Arbeit mit Word-Dokumenten über eine standardisierte Schnittstelle und bietet umfangreiche Funktionen zur Dokumentbearbeitung.
Überblick
Office-Word-MCP-Server implementiert das Model Context Protocol , um Word-Dokumentoperationen als Werkzeuge und Ressourcen verfügbar zu machen. Es dient als Brücke zwischen KI-Assistenten und Microsoft Word-Dokumenten und ermöglicht die Dokumenterstellung, das Hinzufügen von Inhalten, die Formatierung und die Analyse.
Der Server verfügt über eine modulare Architektur, die die Belange in Kernfunktionen, Tools und Dienstprogramme unterteilt, wodurch er äußerst wartungsfreundlich und für zukünftige Verbesserungen erweiterbar ist.
Beispiel
Eingabeaufforderung
Ausgabe
Merkmale
Dokumentenmanagement
- Neue Word-Dokumente mit Metadaten erstellen
- Text extrahieren und Dokumentstruktur analysieren
- Anzeigen von Dokumenteigenschaften und Statistiken
- Verfügbare Dokumente in einem Verzeichnis auflisten
- Erstellen Sie Kopien vorhandener Dokumente
- Mehrere Dokumente zu einem einzigen Dokument zusammenführen
- Konvertieren Sie Word-Dokumente in das PDF-Format
Inhaltserstellung
- Überschriften mit unterschiedlichen Ebenen hinzufügen
- Einfügen von Absätzen mit optionaler Formatierung
- Erstellen Sie Tabellen mit benutzerdefinierten Daten
- Bilder mit proportionaler Skalierung hinzufügen
- Seitenumbrüche einfügen
- Hinzufügen von Fußnoten und Endnoten zu Dokumenten
- Fußnoten in Endnoten umwandeln
- Fußnoten- und Endnotenstil anpassen
Rich-Text-Formatierung
- Formatieren Sie bestimmte Textabschnitte (fett, kursiv, unterstrichen)
- Ändern Sie die Textfarbe und die Schrifteigenschaften
- Anwenden benutzerdefinierter Stile auf Textelemente
- Suchen und Ersetzen von Text in allen Dokumenten
- Formatieren von Tabellen mit Rahmen und Stilen
- Erstellen Sie Kopfzeilen mit eindeutiger Formatierung
- Anwenden von Zellenschattierungen und benutzerdefinierten Rahmen
- Strukturtabellen für bessere Lesbarkeit
Erweiterte Dokumentbearbeitung
- Absätze löschen
- Erstellen Sie benutzerdefinierte Dokumentstile
- Wenden Sie in allen Dokumenten eine einheitliche Formatierung an
- Formatieren Sie bestimmte Textbereiche mit detaillierter Kontrolle
Dokumentenschutz
- Fügen Sie Dokumenten einen Kennwortschutz hinzu
- Implementieren Sie eingeschränkte Bearbeitung mit bearbeitbaren Abschnitten
- Fügen Sie Dokumenten digitale Signaturen hinzu
- Überprüfen Sie die Authentizität und Integrität von Dokumenten
Installation
Installation über Smithery
So installieren Sie Office Word Document Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude
Voraussetzungen
- Python 3.8 oder höher
- Pip-Paketmanager
Grundinstallation
# Clone the repository
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server
# Install dependencies
pip install -r requirements.txt
Verwenden des Setup-Skripts
Alternativ können Sie das bereitgestellte Setup-Skript verwenden, das Folgendes behandelt:
- Voraussetzungen prüfen
- Einrichten einer virtuellen Umgebung
- Installieren von Abhängigkeiten
- MCP-Konfiguration generieren
Verwendung mit Claude für Desktop
Konfiguration
Methode 1: Nach der lokalen Installation
- Fügen Sie den Server nach der Installation zu Ihrer Claude for Desktop-Konfigurationsdatei hinzu:
{
"mcpServers": {
"word-document-server": {
"command": "python",
"args": ["/path/to/word_mcp_server.py"]
}
}
}
Methode 2: Ohne Installation (mit uvx)
- Sie können Claude für Desktop auch so konfigurieren, dass der Server ohne lokale Installation verwendet wird, indem Sie den uvx-Paketmanager verwenden:
{
"mcpServers": {
"word-document-server": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}
- Speicherorte der Konfigurationsdateien:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Starten Sie Claude für Desktop neu, um die Konfiguration zu laden.
Beispieloperationen
Nach der Konfiguration können Sie Claude bitten, folgende Vorgänge auszuführen:
- „Erstellen Sie ein neues Dokument mit dem Namen ‚report.docx‘ und einem Titelblatt.“
- „Fügen Sie meinem Dokument eine Überschrift und drei Absätze hinzu.“
- "Fügen Sie eine 4x4-Tabelle mit Verkaufsdaten ein"
- „Formatieren Sie das Wort ‚wichtig‘ in Absatz 2 so, dass es fett und rot ist.“
- „Suchen und ersetzen Sie alle Vorkommen von ‚alter Begriff‘ durch ‚neuer Begriff‘“
- "Erstellen Sie einen benutzerdefinierten Stil für Abschnittsüberschriften"
- „Formatierung auf die Tabelle in meinem Dokument anwenden“
API-Referenz
Dokumenterstellung und -eigenschaften
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)
convert_to_pdf(filename, output_filename=None)
Inhaltsergänzung
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)
get_document_text(filename)
get_paragraph_text_from_document(filename, paragraph_index)
find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)
Textformatierung
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)
format_table(filename, table_index, has_header_row=None,
border_style=None, shading=None)
Fehlerbehebung
Häufige Probleme
- Fehlende Stile
- In einigen Dokumenten fehlen möglicherweise die erforderlichen Stile für Überschriften- und Tabellenoperationen
- Der Server versucht, fehlende Stile zu erstellen oder eine direkte Formatierung zu verwenden
- Für optimale Ergebnisse verwenden Sie Vorlagen mit Standard-Word-Stilen
- Berechtigungsprobleme
- Stellen Sie sicher, dass der Server über die Berechtigung zum Lesen/Schreiben der Dokumentpfade verfügt
- Verwenden Sie die Funktion
copy_document , um bearbeitbare Kopien gesperrter Dokumente zu erstellen - Überprüfen Sie den Dateibesitz und die Berechtigungen, wenn Vorgänge fehlschlagen
- Probleme beim Einfügen von Bildern
- Verwenden Sie absolute Pfade für Bilddateien
- Überprüfen Sie die Kompatibilität des Bildformats (JPEG, PNG empfohlen)
- Überprüfen Sie die Größe und Berechtigungen der Bilddatei
Debuggen
Aktivieren Sie die detaillierte Protokollierung, indem Sie die Umgebungsvariable festlegen:
export MCP_DEBUG=1 # Linux/macOS
set MCP_DEBUG=1 # Windows
Beitragen
Beiträge sind willkommen! Senden Sie gerne einen Pull Request.
- Forken Sie das Repository
- Erstellen Sie Ihren Feature-Zweig (
git checkout -b feature/amazing-feature ) - Übernehmen Sie Ihre Änderungen (
git commit -m 'Add some amazing feature' ) - Pushen zum Zweig (
git push origin feature/amazing-feature ) - Öffnen einer Pull-Anfrage
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.
Danksagung
Hinweis: Dieser Server interagiert mit Dokumentdateien auf Ihrem System. Überprüfen Sie immer, ob die angeforderten Vorgänge korrekt sind, bevor Sie sie in Claude für Desktop oder anderen MCP-Clients bestätigen.