office-oxide-mcp

office-oxide-mcp

用于处理 Office 文档（Excel、Word、PowerPoint、PDF）的 Rust 原生 MCP 服务。
亚毫秒级、以本地为先、开源——「开源版 Aspose」。

PDF 让人头疼。 我们生活在官僚主义盛行的国家，每份表格都要反复填写姓名、地址和出生日期。银行申请、税务表格、保险理赔、政府许可、租赁协议。字段相同，PDF 不同，却要无休止地重复输入。
别再手动填写表格了。 让 office-oxide-mcp 在几毫秒内帮你填写，无论是简单的 AcroForm、复杂的 XFA 表单，还是需要按坐标填写的扁平扫描 PDF。大模型读取表单，你确认后，它就会填写。完成。

提示

加入我们！

	加入我们的 Discord 社区，提问、分享想法，并获取 office-oxide-mcp 的帮助。
	更喜欢 GitHub？发起讨论或提交问题。
	在 GitHub 上关注 @Aimino-Tech，了解更多项目。

---

快速开始

cargo install office-oxide-mcp

或从 GitHub Releases 下载。

Claude Desktop

{
  "mcpServers": {
    "office": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

Cursor

{
  "mcpServers": {
    "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

VS Code（Copilot）

{
  "servers": {
    "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

---

使用场景

以下每份文档均由 office-oxide-mcp 生成 — 点击即可下载。

#	格式	使用场景	技能	预览
1	XLSX	损益表	excel.basic
2	XLSX	高管 KPI 仪表板	excel.basic
3	XLSX	预算与实际差异	excel.basic
4	XLSX	含比率的资产负债表	excel.basic
5	XLSX	收入预测	excel.basic
6	XLSX	成本分析	excel.basic
7	DOCX	发票	word.invoice
8	DOCX	年度业务报告	word.report
9	DOCX	IT 服务协议	word.report
10	DOCX	数字战略报告	word.report
11	PDF	财务报告导出	office_export_pdf
12	PPTX	战略咨询演示文稿	ppt.deck
13	PPTX	CFO 季度业务回顾	ppt.deck
14	PPTX	产品发布战略演示文稿	ppt.deck
15	PPTX	并购目标分析演示文稿	ppt.deck
16	PPTX	数字化转型路线图	ppt.deck

交互式展示 → showcase/use-cases.html，包含完整提示词、JSON-RPC 调用和详细信息。

---

工具概览

工具	描述	输入
list_formats	所有受支持的 Office 格式及其功能	—
get_document_info	文件元数据（格式、大小、可读性）	file_path
office_read	读取内容 → JSON / Markdown / 分块 / 文本	file_path、output_format
office_fill_pdf_form	填写 PDF 中的 AcroForm/XFA 表单字段	file_path、output_path、fields
office_list_pdf_fields	列出 PDF 中的所有表单字段及其值	file_path
office_overlay_pdf_text	在扁平 PDF 的指定坐标处插入文本	file_path、output_path、fields
office_analyze_pdf_layout	分析 PDF 布局以确定叠加坐标	file_path
increment	增加计数器的值（演示）	—
get_value	获取当前计数器的值（演示）	—

完整工具套件

AI 阅读： to_md、to_json、to_chunks、excel_schema、coherence_check

Excel 写入： office_create_xlsx、office_write_cell、office_write_range、office_format_range、office_create_chart、office_create_pivot、office_add_sheet、office_rename_sheet、office_delete_sheet、office_merge_cells、office_set_column_width、office_apply_conditional_format

Word 写入： office_create_docx、office_write_docx_from_md、office_replace_text、office_set_style、office_add_table、office_add_image、office_add_header_footer、office_add_toc、office_add_comment、office_accept_changes

PPT 写入： office_create_pptx、office_add_slide、office_set_slide_layout、office_add_text_box、office_add_chart、office_add_image

技能系统： skill_run、skill_list、skill_validate、skill_register

一致性引擎： office_propagate_edit、office_check_consistency

PDF： office_read（Markdown/文本/JSON/分块）、office_fill_pdf_form、office_list_pdf_fields、office_overlay_pdf_text、office_analyze_pdf_layout、office_export_pdf

---

架构

┌────────────────────────────────────────────────────────┐
│                     Tool Layer                          │
│  AI Reading · Excel/Word/PPT · PDF · Skills · Coherence│
├────────────────────────────────────────────────────────┤
│                    Format Engines                       │
│  calamine · rust_xlsxwriter · rdocx · office_oxide     │
│          6 Office formats + PDF (lopdf)                │
├────────────────────────────────────────────────────────┤
│                  ZIP + XML + PDF Layer                  │
│    quick-xml (zero-copy) · zip · zlib-ng (SIMD) · lopdf│
├────────────────────────────────────────────────────────┤
│                 Semantic Layer                          │
│    Entity DAG · BFS propagation · Stale detection      │
└────────────────────────────────────────────────────────┘

---

性能基准

操作	Python	office-oxide-mcp	加速比
读取 1000 万个单元格的 XLSX（openpyxl）	239s	~25s	~10×
写入 10 万个单元格的 XLSX（openpyxl）	1.8s	152ms	~12×
DOCX 平均读取时间（6000 份文档）	11.8ms	0.8ms	~14×
PPTX 平均读取时间（323 张幻灯片）	32.5ms	0.7ms	~46×
MCP 工具调用（FastMCP）	3ms	0.38ms	~6×
冷启动	1-5s	<50ms	~100×
空闲时内存占用	42.7MB	<2MB	~20×

---

构建

cargo build                           # Debug
cargo build --release                 # Release
cargo clippy                          # Lint
cargo doc --open                      # Docs

贡献

请参阅 CONTRIBUTING.md。欢迎所有贡献。

许可证

MIT OR Apache-2.0 — 请参阅 LICENSE。