Skip to main content
Glama

Office-Word-MCP-服务器

用于创建、读取和操作 Microsoft Word 文档的模型上下文协议 (MCP) 服务器。该服务器使 AI 助手能够通过标准化界面处理 Word 文档,并提供丰富的文档编辑功能。

概述

Office-Word-MCP-Server 实现了模型上下文协议 (MCP) ,将 Word 文档操作公开为工具和资源。它充当 AI 助手和 Microsoft Word 文档之间的桥梁,支持文档创建、内容添加、格式化和分析。

该服务器采用模块化架构,将关注点分为核心功能、工具和实用程序,使其具有高度的可维护性和可扩展性,以便在未来进行增强。

例子

提示

图像

输出

图像

Related MCP server: Appwrite MCP Server

特征

文档管理

  • 使用元数据创建新的 Word 文档

  • 提取文本并分析文档结构

  • 查看文档属性和统计信息

  • 列出目录中的可用文档

  • 创建现有文档的副本

  • 将多个文档合并为一个文档

  • 将 Word 文档转换为 PDF 格式

内容创作

  • 添加不同级别的标题

  • 插入具有可选样式的段落

  • 使用自定义数据创建表

  • 添加按比例缩放的图像

  • 插入分页符

  • 向文档添加脚注和尾注

  • 将脚注转换为尾注

  • 自定义脚注和尾注样式

富文本格式

  • 格式化特定的文本部分(粗体、斜体、下划线)

  • 更改文本颜色和字体属性

  • 将自定义样式应用于文本元素

  • 在整个文档中搜索和替换文本

表格格式

  • 使用边框和样式设置表格格式

  • 创建具有不同格式的标题行

  • 应用单元格底纹和自定义边框

  • 构建表格以提高可读性

高级文档操作

  • 删除段落

  • 创建自定义文档样式

  • 在整个文档中应用一致的格式

  • 使用详细控制来格式化特定范围的文本

文档保护

  • 为文档添加密码保护

  • 使用可编辑部分实现限制编辑

  • 向文档添加数字签名

  • 验证文件的真实性和完整性

安装

先决条件

  • Python 3.8 或更高版本

  • pip 包管理器

基本安装

# Clone the repository git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git cd Office-Word-MCP-Server # Install dependencies pip install -r requirements.txt

使用安装脚本

或者,您可以使用提供的安装脚本来处理:

  • 检查先决条件

  • 设置虚拟环境

  • 安装依赖项

  • 生成 MCP 配置

python setup_mcp.py

与 Claude 桌面版一起使用

配置

方法 1:本地安装后

  1. 安装后,将服务器添加到您的 Claude for Desktop 配置文件中:

{ "mcpServers": { "word-document-server": { "command": "python", "args": ["/path/to/word_mcp_server.py"] } } }

方法二:无需安装(使用 uvx)

  1. 您还可以使用 uvx 包管理器将 Claude for Desktop 配置为使用服务器而无需本地安装:

{ "mcpServers": { "word-document-server": { "command": "uvx", "args": ["--from", "office-word-mcp-server", "word_mcp_server"] } } }
  1. 配置文件位置:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. 重新启动 Claude for Desktop 以加载配置。

示例操作

配置完成后,您可以要求 Claude 执行如下操作:

  • “创建一个名为‘report.docx’的新文档,并添加标题页”

  • “在我的文档中添加一个标题和三个段落”

  • “插入包含销售数据的 4x4 表格”

  • 将第 2 段中的“重要”一词格式化为粗体和红色

  • “搜索并将所有‘旧术语’替换为‘新术语’”

  • “为章节标题创建自定义样式”

  • “将格式应用于我的文档中的表格”

API 参考

文档创建和属性

create_document(filename, title=None, author=None) get_document_info(filename) get_document_text(filename) get_document_outline(filename) list_available_documents(directory=".") copy_document(source_filename, destination_filename=None) convert_to_pdf(filename, output_filename=None)

内容添加

add_heading(filename, text, level=1) add_paragraph(filename, text, style=None) add_table(filename, rows, cols, data=None) add_picture(filename, image_path, width=None) add_page_break(filename)

内容提取

get_document_text(filename) get_paragraph_text_from_document(filename, paragraph_index) find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)

文本格式

format_text(filename, paragraph_index, start_pos, end_pos, bold=None, italic=None, underline=None, color=None, font_size=None, font_name=None) search_and_replace(filename, find_text, replace_text) delete_paragraph(filename, paragraph_index) create_custom_style(filename, style_name, bold=None, italic=None, font_size=None, font_name=None, color=None, base_style=None)

表格格式

format_table(filename, table_index, has_header_row=None, border_style=None, shading=None)

故障排除

常见问题

  1. 缺少样式

    • 某些文档可能缺少标题和表格操作所需的样式

    • 服务器将尝试创建缺失的样式或使用直接格式化

    • 为获得最佳效果,请使用具有标准 Word 样式的模板

  2. 权限问题

    • 确保服务器具有读取/写入文档路径的权限

    • 使用copy_document函数创建锁定文档的可编辑副本

    • 如果操作失败,请检查文件所有权和权限

  3. 图像插入问题

    • 对图像文件使用绝对路径

    • 验证图像格式兼容性(推荐 JPEG、PNG)

    • 检查图像文件大小和权限

调试

通过设置环境变量启用详细日志记录:

export MCP_DEBUG=1 # Linux/macOS set MCP_DEBUG=1 # Windows

贡献

欢迎贡献代码!欢迎提交 Pull 请求。

  1. 分叉存储库

  2. 创建你的功能分支( git checkout -b feature/amazing-feature

  3. 提交您的更改( git commit -m 'Add some amazing feature'

  4. 推送到分支( git push origin feature/amazing-feature

  5. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

致谢


注意:此服务器会与您系统上的文档文件进行交互。请务必在 Claude for Desktop 或其他 MCP 客户端中确认请求的操作是否正确。

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GongRzhe/Office-Word-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server