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 lokal — die Dateien verlassen deinen Rechner nicht.

crgx installieren (einmalig)

crgx ist ein npx-artiger Runner für Rust-Binaries — er lädt office_oxide_mcp beim ersten Aufruf automatisch nach. Keine manuelle MCP-Installation nötig.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Konfiguration

Nach der crgx-Installation die folgende Konfiguration in dein KI-Tool kopieren. crgx kümmert sich um Download und Updates von office_oxide_mcp.

Claude Desktop

In ~/.config/claude/claude_desktop_config.json (Linux) bzw. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) eintragen:

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

Claude Code

In die .claude/settings.json des Projekts eintragen:

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

Cursor

In die MCP-Einstellungen von Cursor eintragen:

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

Alternative Installation

Wer kein crgx möchte, installiert office_oxide_mcp direkt:

cargo install office_oxide_mcp

Und verweist das KI-Tool auf die Binary:

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

Verfügbare Tools

extract

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

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

convert

Konvertieren zwischen Formaten — vor allem Legacy → OOXML.

Parameter Typ Pflicht Beschreibung
input_path string Ja Quelldatei
output_path string Ja Zieldatei (Format ergibt sich aus der Erweiterung)

Wie es funktioniert

Der MCP-Server spricht stdio JSON-RPC 2.0. Wenn ein KI-Assistent ein Office-Dokument lesen will, schickt er einen tools/call-Request und erhält eine Bestätigung mit Verweis auf die Output-Datei.

Die gesamte Verarbeitung passiert lokal mit dem gleichen Rust-Extraktions-Engine wie Library und CLI — keine Daten gehen an externe Dienste.

Gut funktionierende Prompts

  • „Schreib das Markdown von 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 will die Tabellenstruktur sehen."

Im Hintergrund schickt der Assistent etwa folgenden JSON-RPC-Aufruf:

{
  "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; der Assistent liest die Datei dann zurück in seinen Kontext.

Siehe auch