Word文档追踪修改服务

Word MCP Server是一个支持Claude编辑Word文档并保留追踪修改记录的服务,适用于需要详细文档修改历史的专业环境。

  • by juanocampo400
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 juanocampo400/word-mcp

使用说明

Word MCP服务器

使用Claude编辑Word文档,并支持完全跟踪更改。

为什么存在

我想要一个可以跟踪更改的Word MCP服务器。在专业环境中,您需要查看更改了什么,谁更改了它,并接受或拒绝编辑。

我研究过的其他方法:

  • 基于python docx的服务器 –可以读写.docx文件,但不支持跟踪更改。更改在Word的审阅工作流程中不可见。
  • 微软官方Word MCP -基于云,只读/创建,不直接编辑本地文件,也没有跟踪更改。

此服务器:

  • 完整跟踪更改 –启用修订跟踪,在Word中进行插入/删除的编辑,使用作者和日期元数据进行审阅
  • 直接本地编辑 –磁盘上的.docx文件会发生变化,不依赖于云
  • 45工具 –文档、文本、表格、图像、格式、章节、页眉/页脚等

入门指南

先决条件

  • 视窗 随着 微软Word 已安装(基于COM的跟踪更改需要)
  • Python 3.10+ –检查 python --version

安装

1.克隆仓库:

git clone https://github.com/juanocampo400/word-mcp.git
cd word-mcp

2.安装依赖项:

pip install -e .

3.在克劳德代码中添加:

claude mcp add word-mcp --scope user -- python -m word_mcp.server
Manual configuration

为什么 --scope user? 使服务器在全球范围内可用。没有它,服务器只能在项目目录中工作。

手动配置 --编辑 ~/.claude.json:

{
  "mcpServers": {
    "word-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "word_mcp.server"]
    }
  }
}

如果 python 无法解析,请使用完整路径:

{
  "mcpServers": {
    "word-mcp": {
      "type": "stdio",
      "command": "C:/Users/yourname/AppData/Local/Programs/Python/Python312/python.exe",
      "args": ["-m", "word_mcp.server"]
    }
  }
}

试试看

打开克劳德代码并说:

在C:/Documents/report.docx打开我的文档,启用跟踪更改,然后修复拼写错误

Claude将打开文档,启用跟踪,并在Word中进行显示为跟踪更改的编辑。在Word中打开文件以查看和接受/拒绝。

运作原理

服务器使用两个引擎:

  • python docx 对于大多数操作——文本、样式、表格、图像、部分。快速,不需要Word运行。
  • pywin32 COM自动化 对于pythondocx不能做的事情——跟踪更改、删除行/列、重新定位图像。需要安装Word。

当运行COM操作时,文档会保存到磁盘,通过Word的COM接口进行编辑,然后重新加载到python docx中。这种桥接模式使两个引擎保持同步。

备注

  • 仅限Windows(COM自动化需要Microsoft Word)
  • 可以同时打开多个文档
  • 文档在明确保存之前一直保存在内存中——没有自动保存
  • COM操作(跟踪更改、一些表/映像操作)要求先将文档保存到磁盘

可用工具

文档管理

工具 说明
create_document 创建新的空白文档
open_document 从磁盘打开.docx文件
save_document 保存到当前路径
save_document_as 保存到新路径
close_document 关闭并放弃未保存的更改
get_document_info 获取正在使用的段落、单词、页面和样式
create_from_template 从.docx/.dotx模板创建
list_open_documents 列出所有打开的文档

内容编辑

工具 说明
read_document 阅读带有索引和样式的段落
add_paragraph 添加或插入段落
edit_paragraph 用索引替换段落文本
delete_paragraph 按索引删除段落
search_text 跨段落搜索文本
replace_text 查找和替换文本

样式和格式

工具 说明
apply_heading_style 应用标题样式(H1-H9)
apply_style 按名称应用任何段落样式
format_text 粗体、斜体、下划线、字体、大小、颜色
get_paragraph_formatting 检查每次运行的格式细节

跟踪更改

工具 说明
enable_tracked_changes 启用带有作者姓名的修订跟踪
disable_tracked_changes 禁用跟踪(保留现有修订)
get_tracked_changes 列出修订内容,包括类型、作者、日期和文本
tracked_add_paragraph 添加段落作为跟踪插入
tracked_edit_paragraph 编辑创建跟踪删除+插入
tracked_delete_paragraph 删除为跟踪删除(删除线)

表格

工具 说明
create_table 使用可选数据和样式创建表
list_tables 列出所有带尺寸的表
read_table 将表格读取为格式化网格
edit_table_cell 按行/列索引编辑单元格
add_table_row 用可选数据附加行
add_table_column 在列后添加可选数据
delete_table_row 删除行(需要保存文档)
delete_table_column 删除列(需要保存文档)

图像

工具 说明
insert_image 插入内联图像,可选择调整大小
resize_image 调整现有图像的大小
list_images 列出所有带尺寸的图像
reposition_image 转换为浮动和绝对定位

截面和页眉/页脚

工具 说明
list_sections 列出带有方向、边距和尺寸的部分
add_section 添加部分(新页面、连续等)
modify_section_properties 更改方向、尺寸、边距
get_header / set_header 每节读/写标题内容
get_footer / set_footer 按节读/写页脚内容

评论

工具 说明
get_comments 阅读所有带有作者和日期的评论

监控

工具 说明
get_server_health 内存使用情况、COM池状态、打开的文档

许可证

麻省理工学院