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 із будь-якого з шести підтримуваних форматів Office.

Параметр Тип Обов’язковий Опис
file_path string Так Шлях до файлу .docx, .xlsx, .pptx, .doc, .xls або .ppt
output_path string Так Шлях для запису видобутого вмісту
format string Ні "text" (за замовчуванням), "markdown", "html" або "ir"
from_format string Ні Перевизначає автоматичне визначення формату за розширенням

convert

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

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