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. Funciona totalmente local — nenhum arquivo sai da sua máquina.

Instalar o crgx (somente uma vez)

crgx é um executor estilo npx para binários Rust. Na primeira execução ele baixa o office_oxide_mcp automaticamente, sem precisar instalar o MCP manualmente.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Configuração

Com o crgx instalado, cole a configuração abaixo na sua ferramenta de IA. O crgx cuida do download e das atualizações do office_oxide_mcp automaticamente.

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 o crgx, instale o office_oxide_mcp diretamente:

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 Office suportados.

Parâmetro Tipo Obrigatório Descrição
file_path string Sim Caminho para um arquivo .docx, .xlsx, .pptx, .doc, .xls ou .ppt
output_path string Sim Caminho onde o conteúdo extraído será gravado
format string Não "text" (padrão), "markdown", "html" ou "ir"
from_format string Não Substitui a detecção automática de formato pela extensão

convert

Converte entre formatos — principalmente de formatos legados para 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 se comunica via stdio JSON-RPC 2.0. Quando um assistente de IA precisa ler um documento Office, ele envia uma requisição 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 — nenhum dado é enviado para serviços externos.

Prompts que funcionam bem

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

Por baixo dos panos, o assistente emite uma chamada JSON-RPC parecida com 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"
    }
  }
}

O servidor grava o resultado em output_path e retorna uma confirmação curta; o assistente então lê o arquivo de volta para o seu contexto.

Veja também