Skip to content
Office Oxide

Servidor MCP Office Oxide — Início Rápido

office-oxide-mcp é um servidor Model Context Protocol que permite a assistentes de IA extrair conteúdo de documentos Office. Ele roda localmente — os arquivos não saem da sua máquina.

Instalar crgx (uma vez)

crgx é um runner estilo npx para binários Rust — baixa o office_oxide_mcp automaticamente na primeira execução. Não precisa instalar o MCP manualmente.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Configuração

Depois de instalar o crgx, cole a configuração abaixo na sua ferramenta de IA. O crgx cuida do download e atualização do office_oxide_mcp.

Claude Desktop

Adicione em ~/.config/claude/claude_desktop_config.json (Linux) ou ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Claude Code

Adicione no .claude/settings.json do projeto:

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

Cursor

Adicione nas configurações MCP do Cursor:

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

Instalação alternativa

Se preferir não usar crgx, instale o office_oxide_mcp direto:

cargo install office_oxide_mcp

E aponte sua ferramenta de IA para o binário:

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

Ferramentas disponíveis

extract

Extrai texto, Markdown, HTML ou IR estruturado de qualquer um dos seis formatos suportados.

Parâmetro Tipo Obrigatório Descrição
file_path string Sim Caminho para um .docx, .xlsx, .pptx, .doc, .xls ou .ppt
output_path string Sim Caminho para escrever o conteúdo extraído
format string Não "text" (default), "markdown", "html" ou "ir"
from_format string Não Sobrescreve a detecção por extensão

convert

Converte entre formatos — principalmente legado → OOXML.

Parâmetro Tipo Obrigatório Descrição
input_path string Sim Arquivo de origem
output_path string Sim Arquivo de destino (formato inferido pela extensão)

Como funciona

O servidor MCP fala stdio JSON-RPC 2.0. Quando um assistente de IA precisa ler um documento Office, manda um tools/call e recebe uma confirmação apontando para o arquivo de saída.

Todo o processamento acontece localmente usando o mesmo motor Rust da biblioteca e do CLI — nada é enviado a serviços externos.

Prompts que funcionam bem

  • “Exporte o Markdown de quarterly.docx em quarterly.md.”
  • “Converta legacy/old_report.doc para modern/old_report.docx.”
  • “Extraia slides.pptx como HTML em slides.html para eu pré-visualizar no navegador.”
  • “Despeje o IR JSON de pricing.xlsx em pricing.ir.json; quero ver a estrutura de tabela.”

Por baixo, o assistente faz uma chamada JSON-RPC parecida com:

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

O servidor escreve o resultado em output_path e devolve uma confirmação curta; o assistente lê esse arquivo de volta para o contexto.

Veja também