文档编辑工具 506058115-cmd/dsh-document-editor

dsh-document-editor

用于读取、创建、编辑和验证 PDF、Word、Excel 和 PowerPoint 文件的 DSH MCP 服务器。这些工具使用现有的 Python 库并返回结构化结果。

工具

| 格式 | 工具 |
| PDF | create_pdf、read_pdf、edit_pdf |
| Word（.docx） | create_word_document、read_word_document、modify_word_document |
| Excel（.xlsx） | create_excel_workbook、read_excel_workbook、modify_excel_worksheet |
| PowerPoint（.pptx） | create_pptx_presentation、read_pptx_presentation、modify_pptx_presentation |
| 全部四种 | verify_document |

编辑工具默认会创建一个同级的 *_edited 文件，从而保留源文件。传入 output_path 可选择其他目标位置。只有在完整文件成功保存后，写入才会替换目标文件。

安装

需要 Python 3.10 或更高版本。

pip install -r src\requirements.txt

将 cordis.patch.yml 添加到 DSH 配置文件中，并将 command 设置为已安装这些依赖项的 Python 解释器的绝对路径。更改其 MCP 配置后，请重启该配置文件。除非其环境也安装了这些依赖项，否则不要使用 uv run。

使用

路径可以是绝对路径，也可以是相对于 MCP 服务器当前工作目录的路径。工具在写入输出文件时会创建父文件夹。

安全与隐私

该服务器通过 MCP stdio 在本地运行，不发起任何网络请求。它可以读取传递给工具的任何路径，但受运行它的用户的操作系统权限限制。读取工具会将提取的文档内容返回给已连接的 MCP 客户端，由该客户端根据其自身的数据政策进行处理。

格式

PDF

create_pdf 接受 pages: [{content, pagesize?}]，以及可选的 title、author 和 output_path。长文本会根据需要跨越多页；pagesize 接受 A4 或 Letter。中文文本使用 ReportLab 内置的 STSong CID 字体。

read_pdf 返回元数据以及按页提取的文本。edit_pdf 会追加文本页，并默认写入一个副本。verify_document 会严格解析 PDF，并报告页数和可读文本数量。

{
"title": "项目报告", "author": "张三",
"pages": [{"content": "中文报告正文。", "pagesize": "A4"}],
"output_path": "report.pdf"
}

Word

create_word_document 接受 paragraphs: [{text, style?}] 和 tables: [{headers?, rows}]。支持诸如 heading1 和 heading2 之类的标题样式。

modify_word_document 接受 paragraphs、tables 和 table_updates。带有从零开始的 index 的段落会替换该段落；不带索引的段落会被追加。table_updates 条目使用 {table_index, row_index, column_index, text}，索引从零开始。新表格使用 {headers?, rows}。

read_word_document 返回段落和表格单元格数据。

Excel

create_excel_workbook 接受 sheets: [{name, headers?, rows?}]。
modify_excel_worksheet 编辑指定名称的工作表（如需要则创建）；如果省略，则编辑第一个工作表。cells 将 A1 风格的地址映射到值或公式，例如 {"B2": 12, "C2": "=SUM(A2:B2)"}。rows 追加在现有数据之后；提供 headers 时，会更新第 1 行。read_excel_workbook 在 rows 中返回缓存的单元格值，并在单独的 formulas 映射中返回公式表达式；openpyxl 不会重新计算公式。

PowerPoint

create_pptx_presentation 接受 slides: [{layout, title?, content?}]。布局包括 title、title_and_content、section_header、two_content 和 blank。当占位符可用时，文本会添加到占位符中，否则添加到文本框中。

modify_pptx_presentation 接受 slide_data。包含从零开始的 index 可替换该幻灯片的标题/内容；省略则追加一张幻灯片。read_pptx_presentation 返回所有文本形状，不进行截断。

Verify

verify_document(input_path) 检查 PDF 解析或 Office 包 CRC 以及解析器可读性。受支持但损坏的文件返回 success: true, valid: false 并附带错误信息；不支持的扩展名和缺失的文件返回 error。

Check

从插件目录运行：

python scripts\test_e2e.py
python scripts\test_encoding.py

test_e2e.py 执行 MCP 握手，并对四种格式进行往返测试，编辑生成的文件，并调用验证。test_config.py 检查从插件目录外部以部署方式启动的情况。要检查特定安装，请在运行前设置 DOCUMENT_EDITOR_PYTHON、DOCUMENT_EDITOR_SERVER 和 DOCUMENT_EDITOR_CWD。

Examples

validation samples 包含通过 MCP 创建并验证的原始和编辑后的 PDF、DOCX、XLSX 和 PPTX 文件。

Limits

- PDF 创建和编辑处理文本页面；未实现编辑现有页面文本、表单、注释、图像和布局。
- Word 编辑针对段落和表格单元格；高级 Word 功能（如修订跟踪和嵌入对象）仅在 python-docx 的格式支持允许的范围内被保留。
- Excel 公式会被写入和读取，但不会被计算。.xlsx 工具不支持现有工作簿宏。
- PowerPoint 工具编辑幻灯片文本并创建基本的文本优先幻灯片；它们不会渲染幻灯片或编辑图表、媒体或复杂形状几何。
- Office 渲染在 Microsoft Office、WPS、LibreOffice 和 Google Docs 之间可能有所不同。

Files

src/server.py MCP server
src/requirements.txt Python dependencies
scripts/test_e2e.py MCP and document round-trip check
scripts/test_encoding.py Chinese stdio round-trip check
cordis.patch.yml DSH profile entry

MIT License。