A

AI Word文档助手

@GongRzhe/Office-Word-MCP-Server
109 Stars 3.1w 次浏览 GongRzhe 更新于 2026-08-23

一个模型上下文协议服务器，它使人工智能助手能够通过标准化的工具和资源创建、读取、编辑和格式化Microsoft Word文档。

文件系统知识管理与记忆

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "word-document-server": {
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ],
      "command": "uvx"
    }
  }
}

该服务需要配置环境变量：MCP_DEBUG

可用工具 （16 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

create_document 3 个参数 需填 1 项

Create a new Word document with optional metadata. Args: filename: Name of the document to create (with or without .docx extension) title: Optional title for the document metadata author: Optional author for the document metadata

必填参数：filename

add_heading 3 个参数 需填 2 项

Add a heading to a Word document. Args: filename: Path to the Word document text: Heading text level: Heading level (1-9, where 1 is the highest level)

必填参数：filename、text

add_paragraph 3 个参数 需填 2 项

Add a paragraph to a Word document. Args: filename: Path to the Word document text: Paragraph text style: Optional paragraph style name

必填参数：filename、text

add_table 4 个参数 需填 3 项

Add a table to a Word document. Args: filename: Path to the Word document rows: Number of rows in the table cols: Number of columns in the table data: Optional 2D array of data to fill the table

必填参数：filename、rows、cols

add_picture 3 个参数 需填 2 项

Add an image to a Word document. Args: filename: Path to the Word document image_path: Path to the image file width: Optional width in inches (proportional scaling)

必填参数：filename、image_path

get_document_info 1 个参数 需填 1 项

Get information about a Word document. Args: filename: Path to the Word document

必填参数：filename

get_document_text 1 个参数 需填 1 项

Extract all text from a Word document. Args: filename: Path to the Word document

必填参数：filename

get_document_outline 1 个参数 需填 1 项

Get the structure of a Word document. Args: filename: Path to the Word document

必填参数：filename

list_available_documents 1 个参数

List all .docx files in the specified directory. Args: directory: Directory to search for Word documents

该工具无需必填参数，直接调用即可

copy_document 2 个参数 需填 1 项

Create a copy of a Word document. Args: source_filename: Path to the source document destination_filename: Optional path for the copy. If not provided, a default name will be generated.

必填参数：source_filename

format_text 10 个参数 需填 4 项

Format a specific range of text within a paragraph. Args: filename: Path to the Word document paragraph_index: Index of the paragraph (0-based) start_pos: Start position within the paragraph text end_pos: End position within the paragraph text bold: Set text bold (True/False) italic: Set text italic (True/False) underline: Set text underlined (True/False) color: Text color (e.g., 'red', 'blue', etc.) font_size: Font size in points font_name: Font name/family

必填参数：filename、paragraph_index、start_pos、end_pos

search_and_replace 3 个参数 需填 3 项

Search for text and replace all occurrences. Args: filename: Path to the Word document find_text: Text to search for replace_text: Text to replace with

必填参数：filename、find_text、replace_text

delete_paragraph 2 个参数 需填 2 项

Delete a paragraph from a document. Args: filename: Path to the Word document paragraph_index: Index of the paragraph to delete (0-based)

必填参数：filename、paragraph_index

create_custom_style 8 个参数 需填 2 项

Create a custom style in the document. Args: filename: Path to the Word document style_name: Name for the new style bold: Set text bold (True/False) italic: Set text italic (True/False) font_size: Font size in points font_name: Font name/family color: Text color (e.g., 'red', 'blue') base_style: Optional existing style to base this on

必填参数：filename、style_name

format_table 5 个参数 需填 2 项

Format a table with borders, shading, and structure. Args: filename: Path to the Word document table_index: Index of the table (0-based) has_header_row: If True, formats the first row as a header border_style: Style for borders ('none', 'single', 'double', 'thick') shading: 2D list of cell background colors (by row and column)

必填参数：filename、table_index

add_page_break 1 个参数 需填 1 项

Add a page break to the document. Args: filename: Path to the Word document

必填参数：filename

服务介绍

Office-Word-MCP-Server

一个用于创建、读取和操作 Microsoft Word 文档的 Model Context Protocol (MCP) 服务器。该服务器通过标准化接口使 AI 助手能够处理 Word 文档，提供丰富的文档编辑功能。

概述

Office-Word-MCP-Server 实现了 Model Context Protocol，将 Word 文档操作作为工具和资源暴露出来。它充当 AI 助手与 Microsoft Word 文档之间的桥梁，允许进行文档创建、内容添加、格式化和分析。

示例

提示

image

输出

image

功能

文档管理

  • 创建带有元数据的新 Word 文档
  • 提取文本并分析文档结构
  • 查看文档属性和统计信息
  • 列出目录中的可用文档
  • 创建现有文档的副本

内容创建

  • 添加不同级别的标题
  • 插入段落（可选样式）
  • 使用自定义数据创建表格
  • 按比例缩放添加图片
  • 插入分页符

富文本格式

  • 格式化特定文本段落（加粗、斜体、下划线）
  • 更改文本颜色和字体属性
  • 应用自定义样式到文本元素
  • 在整个文档中搜索和替换文本

表格格式

  • 使用边框和样式格式化表格
  • 创建具有独特格式的表头行
  • 应用单元格阴影和自定义边框
  • 结构化表格以提高可读性

高级文档操作

  • 删除段落
  • 创建自定义文档样式
  • 在整个文档中应用一致的格式
  • 详细控制特定范围的文本格式

安装

前提条件

  • 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 for Desktop 一起使用

配置

方法 1：本地安装后

  1. 安装完成后，将服务器添加到您的 Claude for Desktop 配置文件中：
{
  "mcpServers": {
    "word-document-server": {
      "command": "python",
      "args": [
        "/path/to/word_server.py"
      ]
    }
  }
}

方法 2：无需安装（使用 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段中的单词 'important' 设置为加粗并显示为红色"
  • "查找并替换所有 'old term' 实例为 'new term'"
  • "为节标题创建自定义样式"
  • "对我的文档中的表格应用格式"

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)

内容添加

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)

文本格式化

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 Request。

  1. 分叉仓库
  2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交你的更改 (git commit -m 'Add some amazing feature')
  4. 推送到该分支 (git push origin feature/amazing-feature)
  5. 打开 Pull Request

许可证

此项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

致谢

注意：此服务器会与您系统上的文档文件交互。在 Claude for Desktop 或其他 MCP 客户端中确认任何请求的操作之前，请始终验证这些操作是否适当。

查看源码 项目主页

相关 MCP 服务

文件系统
@modelcontextprotocol/filesystem
实现用于文件系统操作的模型上下文协议（MCP）的 Node.js 服务器。
E
Excel文件服务
@negokaz/excel-mcp-server
一个模型上下文协议服务器，使人工智能助手能够读取和写入Microsoft Excel文件，支持xlsx、xlsm、xltx和xltm等格式。
D
DOCX/PDF文档生成服务-MCP（MCP&Agent挑战赛）
KUN03036/LLM_output_with_docxpdf_MCP_Agent_Challenge
暂无简介
思维导图 MCP
WEIAIb/mind-map-mcp
一个用于生成思维导图的 MCP (Model Context Protocol) 服务器。 看起来您的请求中没有提供具体的英文技术文档内容以供翻译。如果您能分享更多详细信息或具体段落，我将能够帮助您将其准确地翻译成中文，同时保留代码块、链接、格式结构和专业术语的准确性。请提供需要翻译的具体文本。