제한된 접근 권한을 통해 로컬 문서, 메일 저장소 및 송장을 검사, 검색, 가져오기 및 변환합니다.
다른 이름 EvotecIT/OfficeIMO, officeimo
- 스타
- 704
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 3.5.1
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- MIT
OfficeIMO Document Tools MCP란?
제한된 접근 권한을 통해 로컬 문서, 메일 저장소 및 송장을 검사, 검색, 가져오기 및 변환합니다.
프로젝트 README에서 생성된 요약
OfficeIMO Document Tools MCP server 정보
OfficeIMO Document Tools는 검사, 변환 및 추출을 통해 문서 라이프사이클을 관리할 수 있는 CLI를 제공합니다. PDF, 송장 및 DOCX, XLSX, PPTX를 포함한 다양한 오피스 형식의 로컬 파일을 처리해야 하는 개발자와 자동화된 워크플로우를 위해 설계되었습니다. 이 도구는 MCP 클라이언트를 위한 로컬 stdio 서버로 작동하며, 사용자는 OFFICEIMO_MCP_ALLOWED_ROOTS 환경 변수를 통해 허용된 디렉토리를 정의해야 합니다.
사용자는 PDF 분할, 최적화, 데이터 삭제(sanitizing) 또는 Tesseract와 같은 OCR 제공자를 사용하여 검색 가능한 스캔본 생성 등 복잡한 PDF 작업을 수행할 수 있습니다. 또한 이 서버는 특화된 송장 워크플로우를 처리하여 XML 송장을 검사, 검증하고 다양한 표준이나 하이브리드 PDF 형식으로 변환할 수 있도록 지원합니다. JSON 출력에서 비밀번호나 문서 텍스트와 같은 민감한 정보를 제외하여 데이터 프라이버시를 보호하는 기능이 내장되어 있습니다. 시스템은 배치 처리 작업 중 안정적인 실행을 보장하기 위해 입력 및 출력 크기에 대한 리소스 제한을 관리합니다.
활용 사례
- 1문서 형식 일괄 변환개발자가 배치 워크플로우를 실행하여 다양한 오피스 파일이 포함된 디렉토리 전체를 PDF 형식으로 변환할 수 있습니다.
- 2XML 송장 검증 및 편집AI 에이전트가 XML 송장을 검사하여 모델 오류를 확인하거나 송장 번호 및 발행일과 같은 특정 필드를 업데이트할 수 있습니다.
- 3검색 가능한 PDF 스캔 생성OCR 제공자를 통해 텍스트 레이어를 추가함으로써 일반 PDF를 검색 가능한 문서로 변환할 수 있습니다.
- 4민감한 PDF 문서의 데이터 삭제사용자가 보고서의 민감한 정보를 제거한 버전을 생성하여 배포 시 안전하게 사용할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
OFFICEIMO_MCP_ALLOWED_ROOTS필수Authorized document and output folders. Separate roots with ':' on macOS/Linux or ';' on Windows. Registry launch requires dotnet dnx with --yes support (qualified with .NET SDK 10.0.113).
| 이름 | 설명 | 유형 |
|---|---|---|
| OFFICEIMO_MCP_ALLOWED_ROOTS | Authorized document and output folders. Separate roots with ':' on macOS/Linux or ';' on Windows. Registry launch requires dotnet dnx with --yes support (qualified with .NET SDK 10.0.113). | 필수 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기OfficeIMO.Tool
OfficeIMO.Tool is the installable command-line interface for OfficeIMO document conversion, extraction, inspection, markup, output, intake, and MCP workflows.
Install
Install it globally from NuGet when you want officeimo available from any directory:
dotnet tool install --global OfficeIMO.Tool
officeimo --version
For a repository-pinned local tool, create or reuse a tool manifest:
dotnet new tool-manifest
dotnet tool install OfficeIMO.Tool
dotnet tool run officeimo help
# The .NET SDK also resolves a manifest-local tool through this shorthand:
dotnet officeimo help
Update or remove a global installation with the standard .NET tool commands:
dotnet tool update --global OfficeIMO.Tool
dotnet tool uninstall --global OfficeIMO.Tool
MCP clients
server.json describes the local STDIO server as io.github.EvotecIT/officeimo, backed by the OfficeIMO.Tool NuGet package. Clients supply OFFICEIMO_MCP_ALLOWED_ROOTS. The agent plugin launches dotnet dnx OfficeIMO.Tool@<package-version> mcp serve --stdio --yes with .NET SDK 10.0.100 or later; the trailing flag accepts the pinned package download on SDKs that prompt, and older SDKs pass it through harmlessly to the MCP host.
Registry clients place the download-consent flag before the package argument. This route requires an SDK whose dotnet dnx --help lists --yes, qualified with SDK 10.0.113. Some other .NET 10 feature bands lack that option; use the plugin's explicit launcher above on those SDKs. The registry entry exposes the same bounded operations as the plugin.
PDF copies and searchable scans
Create a separate PDF, split folder, or searchable scan with an explicit destination:
officeimo pdf extract report.pdf --pages last,1-3 --output selected.pdf
officeimo pdf split report.pdf --pages-per-document 10 --output report-parts
officeimo pdf decrypt protected.pdf --password-env PDF_OWNER_PASSWORD --output clear.pdf
officeimo pdf flatten report.pdf --output raster.pdf --acknowledge-raster-output --dpi 150
officeimo pdf optimize report.pdf --output optimized.pdf
officeimo pdf sanitize report.pdf --output sanitized.pdf
officeimo pdf providers --ocr-provider-assembly ./providers/OfficeIMO.Ocr.Tesseract.dll
officeimo pdf ocr scan.pdf --output searchable.pdf --ocr-provider tesseract-cli --ocr-provider-assembly ./providers/OfficeIMO.Ocr.Tesseract.dll --ocr-language eng
Page selections retain order and repeated pages and support expressions such as
last,1-3, odd, and all,!2. The selected pages are resolved against the captured
input. Existing files or folders require --force; a source or folder containing
it cannot be the destination. Decryption requires the owner password in the named
environment variable. Other protected-document operations retain the PDF engine's
permission and signature policy.
Flattening copies rendered appearances. Native text, forms, links, signatures,
and attachments are omitted, so --acknowledge-raster-output is required.
The managed renderer's fidelity limits still apply. Searchable OCR adds a text
layer to the source pages; confidence does not certify recognition accuracy.
The tool includes no OCR executable or model. Supply a trusted optional provider
deployment with its managed dependencies. OfficeIMO.Ocr.Tesseract registers
tesseract-cli and uses a separately installed Tesseract executable. Repeated
--ocr-option key=value entries configure the provider; executable/model paths
are chosen by the invoking host. See the Tesseract provider options.
These commands emit bounded JSON containing status, artifact paths/counts/bytes,
and diagnostic codes. Document text, recognized words, passwords and provider
messages are excluded. Defaults limit selection to 100 pages or split parts,
input to 256 MiB, output to 512 MiB, and raster work to 25 million pixels per page.
Use the --maximum-pages, --maximum-input-bytes, --maximum-output-bytes, and
--maximum-pixels-per-page options within the ranges listed by officeimo pdf --help.
Invoice workflows
Invoice commands return versioned JSON with separate model, mapping and standards
results. Inspecting an invoice can succeed while reporting invalid model data;
validate returns a failure exit code for those errors. Schema and business-rule
statuses remain NotRun unless standards validation is explicitly configured.
officeimo invoice inspect invoice.xml
officeimo invoice validate invoice.xml
# Replace existing source headers while retaining XML extensions.
officeimo invoice edit invoice.xml --output invoice.edited.xml `
--number INV-002 --issue-date 2026-09-30 --buyer-reference BUYER-002
# Convert with an explicit, pinned target contract.
officeimo invoice convert invoice.xml --output invoice.ubl.xml `
--release En16931_1_3_16 --syntax Ubl --profile En16931
# Create a hybrid invoice with Polish labels and an embedded font.
officeimo invoice hybrid invoice.xml --output invoice.pdf `
--release FacturX_1_09_2_Zugferd_2_5_2 --syntax Cii --profile En16931 `
--language pl-PL --font ./fonts/InvoiceFont.ttf `
--columns Item,Quantity,Unit,NetPrice,Vat,NetAmount `
--unit-display Description --payment-display Description `
--modern --compact-details --page-identity
officeimo invoice batch validate first.xml second.xml --max-items 100 --stop-on-failure
# Validate exact source bytes with pinned authority artifacts and the Saxon runner.
officeimo invoice validate invoice.xml --standards-release En16931_1_3_16 `
--rule-bundle ./rules/xrechnung.zip --saxon-jar ./saxon/saxon-he-12.10.jar
render creates a separate presentation PDF; hybrid embeds the captured CII XML.
An explicit target is required for conversion and rendering. Unmapped source data
and unsupported target fields block those operations. --allow-profile-loss permits only
the documented reductions of lower Factur-X profiles and returns warnings for
them. XML standards validation does not certify the PDF's archival conformance.
edit accepts --number, --issue-date, --due-date, --buyer-reference and
--payment-reference; dates use yyyy-MM-dd. It replaces existing unique
plaintext fields and retains other XML content. Signed XML and unsupported date
representations are blocked. It retains the input syntax/profile and accepts no
target options. A successful edit can report model or mapping errors; inspect
those JSON findings and request standards validation when required. Requested
standards stages must pass on exact edited bytes before publication. Use
batch edit to apply the same captured replacements to several inputs.
File outputs are created atomically and never overwrite existing files. Batch
writing uses --output-directory, naming each output <input-stem>.invoice.xml
or <input-stem>.invoice.pdf. All inputs and destinations are checked before
execution; colliding or existing destinations fail before any output is created.
Batch publication is per item. Limits default to 256 inputs, 64 MiB of combined
input and 64 MiB of returned artifacts. --max-input-bytes and
--max-output-bytes change those combined budgets; each XML input remains limited
to 16 MiB. For the pinned authority downloads and runtime requirements, see the
standards validator guide.
File batches and printing
DOC conversion blocks known legacy import loss by default; --allow-legacy-loss explicitly accepts the reported reductions. TXT conversion treats HTML and Markdown as literal text, detects Unicode BOMs and otherwise uses strict UTF-8. Use --text-encoding and --tab-size for explicit text settings. The adapter's diagnostics remain on standard error.
Batch conversion uses the existing executable workflow catalog. PDF routes include DOC, DOCX, TXT, XLSX, PPTX, HTML, Markdown, RTF, Draw, DjVu and Publisher. Files without an eligible route are counted as skipped. Checkpoints are optional. Resolve relative paths from the directory where the command runs:
officeimo workflow batch --input-directory ./Documents --output ./PDF
# Enable durable checkpoints; rerun to verify and reuse completed artifacts.
officeimo workflow batch --input-directory ./Documents --output ./PDF --checkpoint ./PDF-State
officeimo workflow batch --input-directory ./Documents --output ./PDF --checkpoint ./PDF-State --retry-failed
# Explicit files and other existing conversion targets use the same command.
officeimo workflow batch report.pdf appendix.pdf --output ./HTML --target html
officeimo workflow printers
officeimo workflow printers --paper-sources "Office printer"
officeimo workflow print report.pdf --printer "Office printer" --pages 1-3 `
--pages-per-sheet 2 --copies 1 --duplex long
officeimo workflow print-plan report.pdf --pages-per-sheet 6 --page-subset odd `
--scale custom --custom-scale 40 --alignment bottom-right --margin 18 `
--margin-left 24 --margin-right 24 --color grayscale
Ordinary batches accept --conflict fail|rename|replace. Checkpoint jobs require fail and separate source, output and state trees. Changed completed inputs/settings/resources, altered or missing outputs and existing outputs without a verified receipt require inspection. Concurrency and execution budgets can change without discarding verified artifacts. Item failures produce a nonzero exit code. See the batch contract for resource limits, diagnostics and recorded-artifact reuse across compatible engine updates.
Printer submission uses prepared raster sheets. The returned job identifier proves queue acceptance; physical delivery is unconfirmed. After an interrupted submission, check the queue before retrying. Windows file printers require --output-file naming a new local file. macOS/Linux delivery uses the existing CUPS service boundary and requires its command-line tools.
Both print-plan and print accept 1/2/4/6/9 pages per sheet, --page-subset all|odd|even, nine-position --alignment, and per-edge point margins (--margin-left, --margin-top, --margin-right, --margin-bottom). Odd/even refers to original document page numbers within --pages. --scale custom --custom-scale <percent> uses 1–1000 percent of source physical size and clips overflow. --color grayscale changes the prepared pixels; --color color retains source colors, subject to the device's capabilities. Layout margins do not remove printer hardware margins.
Saved conversion jobs
Save reviewed batch settings without executing them, inspect the plan, then run the same local job from any working directory:
officeimo workflow batch --input-directory ./documents --output ./pdf --checkpoint ./conversion-state --save-job ./monthly.officeimojob.json
officeimo workflow job plan ./monthly.officeimojob.json
officeimo workflow job run ./monthly.officeimojob.json --format ndjson
officeimo workflow job run ./monthly.officeimojob.json --retry-failed
Paths inside the job resolve against its file location. Saving captures portable settings and never reads secret values or converts files. Unknown schema versions, unknown fields and unsupported renderer settings are rejected. A plan reports selection, destinations and collisions without writing outputs or checkpoints; execution revalidates current inputs. Registered iWork routes use the host's ordinary batch registration; checkpoints still require supported built-in routes.
Use --source-password-env NAME and --pdf-password-env NAME for runtime secret
references. Saved jobs never contain password values. PowerShell runs the same
definition with Invoke-OfficeConversionJob -Path ./monthly.officeimojob.json.
Studio's local-folder workbench loads source-folder jobs that target PDF using
automatic route selection and have no password references. Use the CLI or
PowerShell for explicit-file lists, other targets, fixed conversion routes or
jobs with password environment-variable references.
Ordinary workflow batch keeps its aggregate JSON default. --format json
adds a versioned per-file report, bounded to 10,000 retained items and 16 MiB of
serialized item data, with an explicit truncation marker. --format ndjson
streams each item and a final summary. Saved-job execution defaults to the
versioned JSON report. Human diagnostics stay on stderr. A batch with no selected
conversions fails unless --allow-empty explicitly accepts that outcome; partial
failures and cancellation keep their failure/cancellation exit codes and retain
already published outputs.
If discovery or its file budget stops a run after earlier files complete, the
final report retains those item outcomes and includes summary.failureSummary.
The command fails even when no individual conversion failed; JSON and NDJSON
still include the terminal summary.
See the complete job examples for expected results and checkpoint retry instructions.
Retain a readable attempt independently of checkpoint state by choosing a new report path outside the input, output and checkpoint trees:
mkdir runs
officeimo workflow job run ./monthly.officeimojob.json --report ./runs/first.json
officeimo workflow job report ./runs/first.json
officeimo workflow job run ./monthly.officeimojob.json --retry-failed --report ./runs/retry.json
The report parent folder must exist. Existing report files are preserved. Each attempt records the saved definition's fingerprint, timing, aggregate outcome and bounded per-file results. Inspection never runs the job or opens its referenced files. A report left by an exited writer appears as interrupted; a live writer remains running. Reports describe past observations. The normal source, output and checkpoint checks still determine whether an artifact can be reused.
If report creation fails, conversion does not start. If final recording fails after conversions, the command reports the recording error and returns failure while retaining completed outputs and their conversion counts. Use a separate report filename for each attempt rather than replacing earlier evidence.
Common workflows
# Office documents to PDF
officeimo convert report.docx report.pdf
officeimo convert archive.doc archive.pdf
officeimo convert report.txt report.pdf --text-encoding utf-8 --tab-size 4
officeimo convert workbook.xlsx workbook.pdf
officeimo convert deck.pptx deck.pdf
# Draw pages to PDF, with source page sizes and explicit layer/loss choices
officeimo convert diagram.odg diagram.pdf
officeimo convert diagram.fodg diagram.pdf --diagram-layers screen
officeimo convert diagram.odg diagram.pdf --require-no-loss
# OpenDocument, email, EPUB and Visio to PDF
officeimo convert report.odt report.pdf
officeimo convert budget.ods budget.pdf
officeimo convert slides.odp slides.pdf
officeimo convert message.eml message.pdf
officeimo convert message.msg archive.pdf --text-only
officeimo convert book.epub book.pdf
officeimo convert diagram.vsdx diagram.pdf
# Markdown, HTML, RTF and ODT to Word, and Office to OpenDocument and back
officeimo convert notes.md notes.docx
officeimo convert page.html page.docx
officeimo convert letter.rtf letter.docx
officeimo convert report.docx report.odt
officeimo convert report.odt report.docx
officeimo convert workbook.xlsx workbook.ods
officeimo convert deck.pptx deck.odp
# DjVu scans to searchable PDF, using existing text layers
officeimo convert book.djvu book.pdf
officeimo convert scan.djv scan.pdf --require-no-loss
# Convert Apple ZIP files or local directory packages through shared workflows
officeimo convert document.pages document.docx
officeimo convert budget.numbers budget.xlsx
officeimo convert presentation.key presentation.pptx
officeimo convert document.pages document.pdf
# Supported documents to Markdown or JSON through OfficeIMO.Reader
officeimo convert workbook.xlsx workbook.md
officeimo convert report.docx report.json
# Extract to standard output or a file
officeimo read report.docx --format markdown
officeimo extract report.docx --format markdown --output report.md
# Return a compact JSON inspection result
officeimo inspect deck.pptx
# Inspect and convert tabular data without loading an editable workbook
officeimo tabular sheets workbook.xlsx
officeimo tabular schema workbook.xlsx --sheet Data
officeimo tabular convert input.csv output.xlsx
officeimo tabular convert workbook.xlsb output.tsv --sheet Data
officeimo tabular convert pipe-delimited.csv output.csv --delimiter '|' --output-delimiter ','
# Analyze embedded Word images without writing a file
officeimo workflow optimize-images input.docx --analyze
# Optimize a separate Word copy, or choose a .pdf output
officeimo workflow optimize-images input.docx --output optimized.docx --mode both --dpi 144 --quality 85
# Process an explicit batch; each output is independently staged and reopened
officeimo workflow optimize-images first.docx second.docx --output-directory optimized --format pdf --mode both
# Export selected PDF pages to validated images
officeimo workflow export-pages report.pdf --output .\report-pages --pages 1-3,last --format png
# Assemble an ordered PDF from files, folders, images, and ZIP archives
officeimo workflow assemble cover.png report.docx appendices .\attachments.zip --output complete.pdf
# Inspect print-sheet placement without requiring a platform printer driver
officeimo workflow print-plan complete.pdf --paper A4 --pages-per-sheet 2 --scale fit
# Inspect or assess provenance with versioned JSON output
officeimo provenance inspect report.docx
officeimo provenance assess page.html
# Remove selected, structurally valid carriers through the owning format package
officeimo provenance remove report.docx --output report.cleaned.docx
# Plan and apply source-bound PDF redactions through reusable JSON contracts
officeimo pdf redact providers --ocr-provider-assembly ./providers/MyOcr.Provider.dll
officeimo pdf redact plan contract.pdf --recipe redaction.recipe.json --evidence contract.plan.json
officeimo pdf redact apply contract.pdf --recipe redaction.recipe.json --decisions contract.decisions.json `
--output contract-redacted.pdf --evidence contract-redacted.evidence.json `
--ocr-provider my-provider --ocr-language en --ocr-option model=document
officeimo pdf redact batch --request redaction.batch.json
The positional destination is optional for supported Office and Draw inputs to PDF conversion. When omitted, the tool writes a sibling .pdf file. --output <path> remains available for scripts that prefer named options.
Markdown and JSON destinations are semantic Reader projections rather than fixed-layout renderings. They use the same handlers as officeimo reader read and support every input format reported by officeimo reader capabilities.
officeimo reader read accepts iWork directory bundles with .pages, .numbers, or .key extensions as individual documents. Folder discovery also keeps each bundle intact. Export files and asset directories must be outside the source bundle; reported size and content hashes describe the bounded captured package. These Reader outputs are semantic extraction, with the same rendering limits as other Reader routes.
Apple-to-OOXML and Apple-to-PDF conversion accept ZIP files and local directory packages and returns JSON with typed fidelity diagnostics, producer/projection facts, source snapshot SHA-256, coverage, and publication status. Defaults reject partial editable reconstruction and previews without known complete coverage. Use --iwork-mode auto|editable|visual, --allow-partial, --allow-incomplete-preview, and --normalize-worksheet-names only when those acceptance choices fit the task. --max-input-bytes and --max-output-bytes bound conversion. Directory-package checksums describe a private transport ZIP, identified by snapshotKind = DirectoryPackage. Root replacement and changes to file membership or content prevent publication. The destination must be outside the source package and separate from its members. Native permission-scoped directory intake remains outside this local-filesystem contract. PDF requires complete editable reconstruction and retains both source and PDF-stage evidence; partial output, previews, content exclusion and PDF-stage omissions or failures are rejected.
All convert destinations are protected from accidental replacement. Pass --force explicitly when an existing output file should be replaced.
OfficeIMO Document Tools MCP 질문
OfficeIMO.Tool을 어떻게 설치하나요?
'dotnet tool install --global OfficeIMO.Tool' 명령어를 사용하여 NuGet에서 전역으로 설치할 수 있습니다.
이 도구로 스캔된 PDF에 OCR을 수행할 수 있나요?
네, Tesseract와 같은 신뢰할 수 있는 제공자를 지정하면 검색 가능한 OCR을 지원합니다. 단, OCR 실행 파일 자체는 포함되어 있지 않습니다.