Skip to main content
Glama

mcp-office-writer

MCP 服务器:创建、编辑、读取 Office 文档(Word / Excel / PowerPoint / PDF / 纯文本)。

功能速览

类别

工具

读取

read_word_document / read_excel_workbook / read_powerpoint / read_pdf_document / read_pdf_structured / read_txt_document

创建

create_word_document / create_excel_workbook / create_powerpoint / create_pdf_document

Markdown 转换

create_word_from_markdown(MCP 进程直接读源文件,不传全文 JSON)

编辑

edit_word_document / edit_excel_workbook / edit_powerpoint

高保真转换 (dsoffice)

convert_to_pdf / render_document_pages / recalculate_excel_formulas

活动文档 (Windows COM)

get_open_office_documents / edit_open_word_document / edit_open_excel_workbook / edit_open_powerpoint

PPT 优化

ppt_list_color_schemes / ppt_apply_color_scheme / ppt_optimize_slide_layout / ppt_clean_unused_placeholders / ppt_analyze_template / ppt_create_framework_diagram

活动 PPT 流程图

ppt_add_flowchart_slide(COM 实时绘制阶段+节点+箭头)

结构化编辑

inspect_office_document / batch_edit_office_document / merge_office_template

质量验证

validate_word_document

特性:场景模板(学术/报告/公文/合同等,支持国内字号)、模板继承、{{key}} 占位符合并、 原子写入(atomic_save,失败不损坏原文件)、输入文件安全校验(大小/解压炸弹)、 PDF 扫描件 OCR 回退(Tesseract)、COM 活动文档回滚、超时保护。

高保真转换(dsh-libreoffice-kit)

convert_to_pdf / render_document_pages / recalculate_excel_formulas 封装 DeepSeek 开源的 dsh-libreoffice-kit (dsoffice CLI,内置精简版 LibreOffice 引擎,无需本机安装 LibreOffice/Office):

  • convert_to_pdf:docx/xlsx/pptx 及 97-2003 二进制格式(.doc/.xls/.ppt)、.rtf → PDF, 缺失字体按字形度量替换(版式最接近原样)并在 missing_fonts 中报告

  • render_document_pages:Office/PDF → 逐页 PNG(指定页码、Excel 区域、dpi),适合预览图/验收截图

  • recalculate_excel_formulas:重算 xlsx 公式写回缓存值(弥补 openpyxl 公式无缓存值, 转换后 read_excel_workbook 的 data_only 模式可见数值)

环境要求:Node.js ≥ 22.19,npm install -g @deepseek-ai/libreoffice-kit; Windows x64 需 MSVC v14 运行库。缺失时三个工具返回带安装指引的错误信息。

Related MCP server: docx-mcp

启动

start.bat

或直接:

.\venv\Scripts\python.exe -I -X utf8 -m mcp_office_writer

开发

rem 依赖安装(venv 已建好时)
.\venv\Scripts\python.exe -m pip install -e ".[dev]"

rem 运行测试
.\venv\Scripts\python.exe -m pytest tests -q

测试套件 83 个用例:单元(文档操作、PDF 回环、dsoffice 封装层、COM 失败分支、超时守卫、安全回归)+ MCP stdio 端到端(中文往返)。

配置(环境变量)

  • MCP_OFFICE_OCR=0:关闭 PDF 扫描件 OCR

  • TESSERACT_CMD:Tesseract 可执行文件路径(默认 D:\cherry-workplace\tools\tesseract\tesseract.exe)

  • MCP_OFFICE_OCR_LANG:OCR 语言,默认 chi_sim+eng

  • MCP_OFFICE_DSOFFICE:dsoffice 可执行文件路径(默认从 PATH 查找)

Related MCP Connectors

Related MCP Servers