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 і повертає коротке підтвердження; асистент потім читає файл назад у свій контекст.

Дивіться також