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 completamente en local — los archivos no salen de tu equipo.

Instalar crgx (solo una vez)

crgx es un ejecutor al estilo npx para binarios Rust. Descarga office_oxide_mcp automáticamente la primera vez que se ejecuta, sin necesidad de instalar el MCP a mano.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Configuración

Una vez instalado crgx, pega la siguiente configuración en tu herramienta de IA. crgx se encarga de descargar y actualizar office_oxide_mcp de forma automática.

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 el .claude/settings.json de tu 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, puedes instalar office_oxide_mcp directamente:

cargo install office_oxide_mcp

Y apuntar tu herramienta de IA al binario:

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

Herramientas disponibles

extract

Extrae texto, Markdown, HTML o IR estructurado de cualquiera de los seis formatos Office compatibles.

Parámetro Tipo Requerido Descripción
file_path string Sí Ruta a un archivo .docx, .xlsx, .pptx, .doc, .xls o .ppt
output_path string Sí Ruta donde se escribirá el contenido extraído
format string No "text" (por defecto), "markdown", "html" o "ir"
from_format string No Reemplaza la detección de formato basada en extensión

convert

Conversión entre formatos — principalmente de formatos heredados a OOXML.

Parámetro Tipo Requerido Descripción
input_path string Sí Archivo de origen
output_path string Sí Archivo de destino (el formato se infiere de 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 en local usando el mismo motor Rust que la biblioteca y el CLI — ningún dato se envía a servicios externos.

Prompts que funcionan bien

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

Internamente, el asistente emite una llamada JSON-RPC similar a esta:

{
  "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 breve; el asistente lee ese archivo de vuelta a su contexto.

Véase también