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

그리고 AI 도구를 바이너리에 연결:

{
  "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에 쓰고 짧은 확인을 반환합니다. 어시스턴트는 그 파일을 다시 컨텍스트로 읽어 들입니다.

더 보기