dsh-docx-mcp

零依赖的 MCP stdio 服务，根据 JSON 规格生成真正可打开的 .docx 文件（标题 / 段落 / 项目符号列表 / 表格）。 属于 helibeiqi 的 DeepSeek Harness 插件矩阵中的 中文办公自动化 垂直。

• 纯 Node 实现，手写 OOXML + store-zip，无需 npm install、无第三方依赖 —— 与 dsh-quant-data-mcp 同源的「自包含、抗重装」哲学。
• 通过 dsh 的 MCP 桥接（@deepseek-ai/dsh-mcp-client）注册为 docx 工具，供 dsh agent 直接调用。

---

工具：docx_generate

参数	类型	说明
title	string	文档大标题（自动作为一级标题插入开头）
filename	string	输出文件名（可含或不含 .docx）
outDir	string	输出目录，默认 ~/dsh-docx-output
blocks	array	内容块数组（见下）

blocks 内容块

type	字段	说明
heading	level(1-3), text	标题
paragraph	runs(数组 {text,bold}) 或 text,bold	段落；runs 支持同一段落内混合加粗
bullet	items(string[]) 或 text	项目符号列表
table	rows(string[][])	表格，每行是一组单元格

调用示例

{
  "title": "员工劳动合同续签通知书",
  "blocks": [
    { "type": "paragraph", "runs": [
      { "text": "致：", "bold": false },
      { "text": "张三", "bold": true },
      { "text": "（工号 E000123）" }
    ]},
    { "type": "heading", "level": 2, "text": "一、续签事项" },
    { "type": "bullet", "items": ["合同期限：3 年", "试用期：无", "工时制度：标准工时"] },
    { "type": "heading", "level": 2, "text": "二、薪资结构" },
    { "type": "table", "rows": [
      ["项目", "占比"], ["基本工资", "40%"], ["岗位工资", "40%"], ["绩效工资", "20%"]
    ]}
  ]
}

返回 { "path": "...", "bytes": N, "blocks": N }。

---

与 dsh 集成

本仓库是一个 dsh bundle：package.json 声明 dsh.bundle.patch 指向 cordis.patch.yml， 后者以 - insert: 形式向 @deepseek-ai/dsh-mcp-client 注册一个 docx MCP server 行。

路径约定：当前 cordis.patch.yml 中 args / cwd 写的是作者本机的绝对路径 C:\Users\helib\dsh-docx-mcp\...。部署到其他机器时，请改为该机器上 docx-mcp-server.mjs 的实际路径； 或通过 QUANT_MCP_NODE 环境变量指定 Node 运行时（与 dsh-quant-data-mcp 同款硬化写法，可兼容 managed-node 版本目录漂移）。

---

本地运行 / 自测

# 直接起 MCP 服务（stdio）
node docx-mcp-server.mjs

# 自测：生成 selftest.docx 并校验为合法 OOXML 包
node _selftest.mjs

---

Roadmap

• docx_fill_template：对含 {{占位符}} 的 .docx 模板做字段填充（HR 合同 / 通知书高频场景）。
• 页眉页脚、多级编号、字体 / 对齐等段落属性。
• 与 dsh-excel-kit 联动（表格数据 → 文档）。

---

许可

MIT © helibeiqi —— 详见 dsh-ecosystem。