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 и возвращает краткое подтверждение; после этого ассистент читает файл обратно в свой контекст.

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