Skip to content
Office Oxide

Office Oxide MCP-сервер — быстрый старт

office-oxide-mcp — это сервер Model Context Protocol, позволяющий AI-ассистентам извлекать содержимое из Office-документов. Работает локально — файлы не покидают машину.

Установите crgx (один раз)

crgx — npx-подобный раннер для Rust-бинарей; при первом запуске сам скачает office_oxide_mcp. Ручная установка MCP не нужна.

Linux / macOS

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

Windows (PowerShell)

irm crgx.dev/install.ps1 | iex

Конфигурация

После установки crgx вставьте конфиг ниже в свой AI-инструмент. crgx сам скачает и обновит office_oxide_mcp.

Claude Desktop

Добавьте в ~/.config/claude/claude_desktop_config.json (Linux) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Claude Code

Добавьте в .claude/settings.json проекта:

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

Cursor

Добавьте в MCP-настройки Cursor:

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

Альтернативная установка

Если не хочется использовать crgx, ставьте office_oxide_mcp напрямую:

cargo install office_oxide_mcp

И укажите AI-инструменту бинарник:

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

Доступные инструменты

extract

Извлекает текст, Markdown, HTML или структурированный IR из любого из шести форматов.

Параметр Тип Обязательный Описание
file_path string Да Путь к .docx, .xlsx, .pptx, .doc, .xls или .ppt
output_path string Да Куда записать результат
format string Нет "text" (по умолчанию), "markdown", "html" или "ir"
from_format string Нет Переопределить определение формата по расширению

convert

Конвертация между форматами — в основном legacy → OOXML.

Параметр Тип Обязательный Описание
input_path string Да Исходный файл
output_path string Да Целевой файл (формат по расширению)

Как это работает

MCP-сервер говорит stdio JSON-RPC 2.0. Когда AI-ассистенту нужно прочитать Office-документ, он шлёт запрос tools/call и получает подтверждение со ссылкой на выходной файл.

Вся обработка выполняется тем же Rust-движком, что и в библиотеке и CLI, локально — никаких данных наружу.

Удачные подсказки

  • «Выдай Markdown из quarterly.docx в quarterly.md.»
  • «Сконвертируй legacy/old_report.doc в modern/old_report.docx.»
  • «Сделай из slides.pptx HTML в slides.html, чтобы посмотреть в браузере.»
  • «Залей IR JSON pricing.xlsx в pricing.ir.json, хочу глянуть структуру таблицы.»

Под капотом ассистент шлёт примерно такой JSON-RPC:

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

Сервер пишет результат в output_path и возвращает короткое подтверждение; ассистент потом читает файл к себе в контекст.

Смотрите также