使用说明
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池状态、打开的文档 |
许可证
麻省理工学院
