수록 현황:316 건의 뉴스/102 개의 AI 도구/398 개의 오픈소스 프로젝트/74 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / OfficeCLI

OfficeCLI

OfficeCLI는 AI 에이전트가 내장된 시각적 렌더링 기능을 통해 Word, Excel, PowerPoint 문서를 생성, 읽기 및 수정할 수 있게 해주는 단일 바이너리 명령줄 도구입니다.

C#Apache-2.0Application
⭐ GitHubhttps://github.com/iOfficeAI/OfficeCLI
28,451
스타 수
+0
스타 증가율
2026년 8월 13일
최근 업데이트
1
클릭 수

1. 프로젝트 개요

OfficeCLI는 Microsoft Office를 설치하지 않고도 AI 에이전트와 개발자가 Word, Excel, PowerPoint 문서를 생성, 읽기, 분석 및 수정할 수 있게 해주는 단일 바이너리 명령줄 도구로, 높은 충실도의 시각적 렌더링 기능까지 포함하고 있습니다.

2. 배경 및 포지셔닝

OfficeCLI는 스스로를 "AI 에이전트를 위해 설계된 세계 최초이자 최고의 오피스 스위트"라고 설명합니다. 핵심 미션은 자율 AI 시스템에 신뢰할 수 있고 구조화되며 검증 가능한 방식으로 실제 Office 파일을 생성할 수 있는 방법을 제공하여, LLM의 텍스트 출력과 사람이 열어보고 신뢰할 수 있는 완성된 .docx/.xlsx/.pptx 산출물 사이의 격차를 해소하는 것입니다.

COM/UNO 자동화를 통해 Microsoft Office/LibreOffice를 제어하거나 python-docx 및 openpyxl 같은 Python 라이브러리로 스크립팅하는 기존 방식과 비교할 때, OfficeCLI는 처음부터 AI 네이티브로 구축되었습니다. 이는 .NET 런타임이 내장된 단일 독립 실행형 바이너리로 제공되며(Office 설치 불필요, 외부 종속성 없음), LLM이 문서를 추론하는 방식에 깔끔하게 매핑되는 경로 기반 주소 지정 모델(예: /slide[1]/shape[2])을 노출하고, 에이전트가 결과물을 전달하기 전에 시각적으로 직접 확인할 수 있도록 내장 렌더링 엔진을 포함합니다.

3. 기능 범주

  • 📄 문서 작업 — 20개 명령어(create, view, get, set, add, remove, move, swap, batch, validate) — 일관되고 경로 지정 가능한 명령어 세트를 통해 .docx, .xlsx, .pptx 파일의 전체 CRUD 라이프사이클을 지원합니다.
  • 🎨 렌더링 및 미리보기 — HTML, PNG, PDF, SVG 출력 — 문서를 높은 충실도의 시각 자료로 변환하여 에이전트(및 사람)가 결과를 검사할 수 있게 하며, 실시간 새로 고침이 되는 watch 명령어도 포함합니다.
  • 📊 Excel 엔진 — 350개 이상의 내장 함수 — 별도의 스프레드시트 엔진 없이 데이터 범위에서 직접 수식 계산, 동적 배열 및 기본 피벗 테이블 생성을 지원합니다.
  • 🔁 데이터 및 템플릿 — merge, dump — 배치 문서 생성을 위한 {{key}} 플레이스홀더 템플릿 병합 기능과 재생 가능한 문서 청사진을 위한 양방향 JSON 직렬화를 제공합니다.
  • 🤖 AI 에이전트 통합 — MCP 서버, 자동 설치 스킬 — Model Context Protocol 서버(officecli mcp claude)로 등록되며, Claude Code, Cursor, GitHub Copilot 등의 도구에 스킬 파일을 자동으로 감지하고 설치합니다.

4. 주요 하이라이트

  • 종속성 없는 단일 바이너리 — .NET 런타임을 내장하여 Office 설치, COM 자동화, 취약한 시스템 종속성 체인이 전혀 필요 없습니다.
  • 3계층 아키텍처 — L1 의미론적 뷰(텍스트, 개요, 통계), L2 구조화된 DOM 작업(경로를 통한 get/set/add/remove), 그리고 예외적인 경우를 위한 L3 원시 XPath 접근을 제공하여 에이전트에게 고수준의 편의성과 저수준의 제어력을 모두 부여합니다.
  • 내장 시각적 렌더링 — 문서를 요청 시 HTML/PNG/PDF/SVG로 렌더링할 수 있어, AI 에이전트가 원시 XML을 보고 추측하는 대신 자신이 생성한 내용을 "볼" 수 있습니다.
  • 상주 모드 — officecli open은 여러 명령어에 걸쳐 문서를 메모리에 유지하여 지연 시간이 거의 없는 다단계 편집 워크플로를 가능하게 합니다.
  • 원자적 배치 작업 — batch를 통해 여러 편집을 단일 트랜잭션으로 그룹화하여 부분 적용된 변경 사항의 위험을 줄일 수 있습니다.
  • 기본 MCP 지원 — Claude Code, Cursor, VS Code 및 기타 MCP 호환 AI 도구와 즉시 연동되며, 더 깊은 프로그래밍 방식의 통합을 위해 Python 및 Node.js용 SDK를 제공합니다.

5. 역할별 사용 사례

  • 일반 개발자 — Office나 LibreOffice를 번들링하지 않고도 CI 파이프라인이나 백엔드 서비스에서 보고서, 청구서 또는 슬라이드 덱 생성을 자동화할 수 있습니다.
  • AI 에이전트 개발자 — 내장된 MCP 서버를 통해 코딩/오피스 에이전트가 에이전트 워크플로의 일부로 실제 Office 산출물을 생성하고 검증할 수 있는 신뢰할 수 있는 도구를 제공합니다.
  • 데이터/연구 과학자 — 데이터 파이프라인에서 직접 계산된 수식과 피벗 테이블이 포함된 Excel 통합 문서를 생성하거나, 구조화된 데이터로부터 템플릿 기반의 Word/PowerPoint 보고서를 제작할 수 있습니다.
  • 프로젝트 매니저 — 데이터 파일과 함께 merge를 사용하여 단일 템플릿에서 상태 보고서, 제안서 또는 프레젠테이션 덱을 일괄 생성할 수 있습니다.

6. 시작하기

필요한 정보 찾기 — 명령어 참조 및 위키를 탐색하여 형식별 가이드를 확인하세요:

officecli --help
officecli view <file> outline

설치 및 통합:

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
# Claude Code용 MCP 서버로 등록
officecli mcp claude

기여하기:

git clone https://github.com/iOfficeAI/OfficeCLI.git
# 빌드에는 .NET 10 SDK가 필요하며, 출력물은 자체 포함된 네이티브 바이너리입니다.

main 브랜치로 풀 리퀘스트를 제출하거나, 커뮤니티 Discord에 참여하여 아이디어를 먼저 논의해 보세요.

7. 프로젝트 구조

OfficeCLI/
├── src/officecli/     # 핵심 CLI 소스 코드
├── sdk/                # Python 및 Node.js SDK
├── skills/             # AI 에이전트 스킬 정의 (Claude Code, Cursor 등)
├── plugins/            # 확장성 프레임워크
├── schemas/            # OpenXML 유효성 검사 스키마
├── examples/           # 실행 가능한 예제 스크립트
├── npm/                # Node.js 패키지 배포
├── assets/             # 시각적 데모 및 쇼케이스
└── .github/workflows/  # CI/CD 자동화

src/officecli는 3계층 문서 엔진을 포함합니다. skills/는 감지된 AI 코딩 도구에 자동으로 설치되는 구성 요소이며, sdk/는 CLI를 호출하는 대신 프로그래밍 방식의 접근을 원하는 팀을 위한 진입점입니다.

8. 관련 생태계

  • 업스트림/런타임: .NET 10 SDK(빌드 시점), OpenXML 형식 사양(OfficeCLI가 유효성을 검사하는 기준 스키마).
  • AI 도구 통합: Model Context Protocol(MCP), Claude Code, Cursor, VS Code, GitHub Copilot — OfficeCLI는 이러한 도구들에 문서 조작 백엔드로 플러그인됩니다.
  • 보완/대체 도구: Microsoft Office/LibreOffice COM/UNO를 통한 전통적인 자동화 및 python-docx, openpyxl과 같은 Python 라이브러리 — OfficeCLI는 동일한 문제 영역을 AI 네이티브이고 종속성이 없는 CLI로 해결합니다.

9. 라이선스

Apache License 2.0에 따라 라이선스가 부여됩니다.

  • ✅ 상업용 및 비공개 소스 제품을 포함하여 자유롭게 사용, 수정 및 배포할 수 있습니다.
  • ✅ 기여자로부터 명시적인 특허 허가를 포함합니다.
  • ❌ 어떠한 보증도 제공되지 않으며, 소프트웨어는 "있는 그대로(as is)" 제공됩니다.
  • ℹ️ 수정된 버전은 저작권, 라이선스 및 저작자 표시를 유지해야 하며, 변경 사항을 명확히 명시해야 합니다.

10. 자주 묻는 질문

Q: OfficeCLI를 사용하려면 Microsoft Office를 설치해야 합니까?
A: 아니요. OfficeCLI는 .NET 런타임이 내장된 자체 포함 바이너리로 제공되며 OpenXML 파일을 직접 조작합니다.

Q: 어떤 파일 형식이 지원됩니까?
A: .docx(Word), .xlsx(Excel), .pptx(PowerPoint)를 지원하며, Excel 수식 계산 및 피벗 테이블 기능도 포함됩니다.

Q: OfficeCLI는 AI 코딩 어시스턴트와 어떻게 통합됩니까?
A: MCP 서버(officecli mcp claude)로 실행되며, Claude Code, Cursor, VS Code, GitHub Copilot과 같은 지원 도구에 스킬 파일을 자동으로 설치할 수 있습니다.

Q: Office에서 열지 않고 문서를 미리 볼 수 있습니까?
A: 네 — officecli watch <file>을 사용하면 실시간 새로 고침 브라우저 미리보기를 할 수 있고, officecli view <file>을 사용하면 HTML/PNG/PDF/SVG 출력을 렌더링할 수 있습니다.

Q: 프로그래밍 방식의 SDK가 있습니까, 아니면 CLI만 있습니까?
A: 둘 다 있습니다 — officecli-sdk(Python) 또는 @officecli/sdk(Node.js)를 설치하면 코드에서 직접 OfficeCLI 기능을 호출할 수 있습니다.

11. 빠른 링크

12. 요약

OfficeCLI는 AI 도구 환경의 특정 공백을 메웁니다. 즉, 에이전트가 실제 Office 문서를 생성할 수 있도록 종속성이 없고 경로 지정 가능하며 시각적으로 검증 가능한 방식을 제공합니다. 문서 생성 파이프라인을 구축하는 개발자와 신뢰할 수 있는 Word/Excel/PowerPoint 파일을 출력해야 하는 AI 에이전트를 만드는 팀이 주요 대상입니다. 내장된 렌더링과 MCP 통합은 AI 자체가 자신의 작업을 직접 확인해야 하는 에이전트 워크플로에 특히 적합합니다.