Skip to content
Office Oxide

Office Oxide MCP サーバ — クイックスタート

office-oxide-mcp は AI アシスタントに Office ドキュメントからコンテンツを抽出させる Model Context Protocol サーバです。ローカルで動作 — ファイルはあなたのマシンから出ません。

crgx をインストール（一度きり）

crgx は Rust バイナリ用の npx 風ランナーで、初回実行時に 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

Cursor の MCP 設定に追加:

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

別のインストール方法

crgx を使わない場合は office_oxide_mcp を直接インストール:

cargo install office_oxide_mcp

そしてバイナリを直接指定:

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

利用可能なツール

extract

サポートされている 6 形式のいずれかからテキスト、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

形式間の変換 — 主にレガシー → OOXML。

パラメータ 型 必須 説明
input_path string はい ソースファイル
output_path string はい 出力ファイル（ターゲット形式は拡張子から推定）

仕組み

MCP サーバは stdio JSON-RPC 2.0 を話します。AI アシスタントが Office ドキュメントを読みたいとき、tools/call リクエストを送り、出力ファイルを指す確認を受け取ります。

すべての処理はライブラリと CLI と同じ Rust 抽出エンジンでローカルに行われます — 外部サービスにデータは送られません。

よく効くプロンプト

  • 「quarterly.docx の Markdown を quarterly.md に出して」
  • 「legacy/old_report.doc を modern/old_report.docx に変換」
  • 「slides.pptx をブラウザでプレビューしたいので HTML を slides.html に出して」
  • 「pricing.xlsx の IR JSON を 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 に書き、短い確認を返します。アシスタントはそのファイルをコンテキストに読み戻します。

関連項目