Skip to content
Office Oxide

Servidor MCP Office Oxide — Inicio Rápido

office-oxide-mcp es un servidor Model Context Protocol que permite a los asistentes de IA extraer contenido de documentos Office. Corre localmente — los archivos no salen de tu equipo.

Instalar crgx (una vez)

crgx es un runner estilo npx para binarios Rust — descarga office_oxide_mcp automáticamente en la primera ejecución, sin instalación manual del MCP.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Configuración

Tras instalar crgx, pega la configuración siguiente en tu herramienta de IA. crgx se encarga de descargar y actualizar office_oxide_mcp.

Claude Desktop

Añade en ~/.config/claude/claude_desktop_config.json (Linux) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Claude Code

Añade en .claude/settings.json del proyecto:

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

Cursor

Añade en la configuración MCP de Cursor:

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

Instalación alternativa

Si prefieres no usar crgx, instala office_oxide_mcp directamente:

cargo install office_oxide_mcp

Y apunta tu herramienta al binario:

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

Herramientas disponibles

extract

Extrae texto, Markdown, HTML o IR estructurado desde cualquiera de los seis formatos soportados.

Parámetro Tipo Requerido Descripción
file_path string Sí Ruta a un .docx, .xlsx, .pptx, .doc, .xls o .ppt
output_path string Sí Ruta donde escribir el resultado
format string No "text" (por defecto), "markdown", "html" o "ir"
from_format string No Sobrescribe la detección por extensión

convert

Convierte entre formatos — sobre todo heredado → OOXML.

Parámetro Tipo Requerido Descripción
input_path string Sí Archivo origen
output_path string Sí Archivo destino (formato inferido por la extensión)

Cómo funciona

El servidor MCP habla stdio JSON-RPC 2.0. Cuando un asistente de IA necesita leer un documento Office, envía una solicitud tools/call y recibe una confirmación que apunta al archivo de salida.

Todo el procesamiento ocurre localmente usando el mismo motor Rust de la librería y el CLI — no se envía nada a servicios externos.

Prompts que funcionan bien

  • “Saca el Markdown de quarterly.docx en quarterly.md.”
  • “Convierte legacy/old_report.doc a modern/old_report.docx.”
  • “Extrae slides.pptx como HTML en slides.html para previsualizarlo en el navegador.”
  • “Vuelca el IR JSON de pricing.xlsx en pricing.ir.json, quiero ver la estructura de la tabla.”

Bajo el capó el asistente envía una llamada JSON-RPC del estilo:

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

El servidor escribe el resultado en output_path y devuelve una confirmación corta; el asistente lee ese archivo de vuelta a su contexto.

Véase también