Skip to content
Office Oxide

Office Oxide MCP-Server — Schnellstart

office-oxide-mcp ist ein Model Context Protocol-Server, mit dem KI-Assistenten Inhalte aus Office-Dokumenten extrahieren können. Er läuft vollständig lokal — die Dateien verlassen deinen Rechner nicht.

crgx installieren (einmalig)

crgx ist ein npx-ähnlicher Runner für Rust-Binaries. Beim ersten Aufruf lädt er office_oxide_mcp automatisch herunter, sodass keine manuelle MCP-Installation erforderlich ist.

Linux / macOS

curl -fsSL crgx.dev/install.sh | sh

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Konfiguration

Nach der crgx-Installation kopierst du die folgende Konfiguration in dein KI-Tool. Download und Updates von office_oxide_mcp übernimmt crgx automatisch.

Claude Desktop

Trage in ~/.config/claude/claude_desktop_config.json (Linux) oder ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ein:

{
  "mcpServers": {
    "office-oxide": {
      "command": "crgx",
      "args": ["office_oxide_mcp@latest"]
    }
  }
}

Claude Code

Trage in die .claude/settings.json deines Projekts ein:

{
  "mcpServers": {
    "office-oxide": {
      "command": "crgx",
      "args": ["office_oxide_mcp@latest"]
    }
  }
}

Cursor

Trage in die MCP-Einstellungen von Cursor ein:

{
  "mcpServers": {
    "office-oxide": {
      "command": "crgx",
      "args": ["office_oxide_mcp@latest"]
    }
  }
}

Alternative Installation

Wer auf crgx verzichten möchte, kann office_oxide_mcp direkt installieren:

cargo install office_oxide_mcp

Und das KI-Tool anschließend auf die Binary verweisen lassen:

{
  "mcpServers": {
    "office-oxide": {
      "command": "office-oxide-mcp"
    }
  }
}

Verfügbare Tools

extract

Extrahiert Text, Markdown, HTML oder strukturierte IR aus einem der sechs unterstützten Office-Formate.

Parameter Typ Pflicht Beschreibung
file_path string Ja Pfad zu einer .docx-, .xlsx-, .pptx-, .doc-, .xls- oder .ppt-Datei
output_path string Ja Pfad, in den das extrahierte Ergebnis geschrieben wird
format string Nein "text" (Standard), "markdown", "html" oder "ir"
from_format string Nein Überschreibt die erweiterungsbasierte Format-Erkennung

convert

Konvertierung zwischen Formaten — hauptsächlich von Legacy-Formaten nach OOXML.

Parameter Typ Pflicht Beschreibung
input_path string Ja Quelldatei
output_path string Ja Zieldatei (Zielformat wird aus der Erweiterung ermittelt)

So funktioniert es

Der MCP-Server kommuniziert über stdio JSON-RPC 2.0. Wenn ein KI-Assistent ein Office-Dokument lesen muss, schickt er einen tools/call-Request und erhält eine Bestätigung mit Verweis auf die Ausgabedatei.

Die gesamte Verarbeitung findet lokal statt — mit demselben Rust-Extraktions-Engine wie die Bibliothek und das CLI. Es werden keine Daten an externe Dienste übertragen.

Gut funktionierende Prompts

  • „Schreib das Markdown aus quarterly.docx nach quarterly.md."
  • „Konvertiere legacy/old_report.doc zu modern/old_report.docx."
  • „Exportiere slides.pptx als HTML nach slides.html, damit ich es im Browser ansehen kann."
  • „Dump den IR-JSON von pricing.xlsx nach pricing.ir.json — ich möchte die Tabellenstruktur prüfen."

Im Hintergrund sendet der Assistent einen JSON-RPC-Aufruf wie diesen:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "extract",
    "arguments": {
      "file_path": "/path/quarterly.docx",
      "output_path": "/path/quarterly.md",
      "format": "markdown"
    }
  }
}

Der Server schreibt das Ergebnis nach output_path und liefert eine kurze Bestätigung zurück; der Assistent liest die Datei dann in seinen Kontext ein.

Siehe auch