AI导哈

Word文档自动化服务

Office-Word-MCP是一个企业级文档自动化协议服务器，为AI助手如Amazon Q和Kiro提供创建、读取、操作和分析Microsoft Word文档的标准化接口。

  • by ihatesea69
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ihatesea69/Office-Word-MCP

使用说明

Office Word MCP

Amazon Q&Kiro的企业级文档自动化协议

概述

Office Word MCP 是一个强大的模型上下文协议（MCP）服务器，旨在为AI助手提供高级文档处理功能，如 亚马逊Q开发者, 基罗以及其他符合MCP的客户端。

它为AI代理提供了一个标准化的接口，用于编程创建、读取、操作和分析Microsoft Word文档(.docx).通过将复杂的文档对象模型抽象到干净的API工具中，它使人工智能助手能够自主生成专业报告、合同和文档工作流程。

主要优势

  • 无缝集成：针对Amazon Q和Kiro环境进行了优化。
  • 丰富的格式：支持复杂的表、样式和布局控件。
  • 企业级就绪：包括文档保护、评论分析和结构化数据处理。
  • 安全：在本地运行，具有明确的权限控制。

建筑

特性

1.文件管理

  • 生命周期控制：创建、复制、合并和转换文档（PDF）。
  • 结构分析：提取大纲、元数据和统计数据。
  • 安全：应用密码保护并管理受限编辑。

2.内容工程

  • 高级表格：使用合并、着色和自定义边框创建复杂的布局。
  • 富文本：字体、颜色和段落样式的精度控制。
  • 媒体：插入按比例缩放的图像。
  • 动态列表：符合XML的项目符号和编号列表。

3.审查与合作

  • 评论挖掘：按作者或内容提取和过滤评论。
  • 跟踪更改（未来路线图）支持修订跟踪。

入门指南

先决条件

  • Python 3.10或更高版本
  • uv （推荐）或 pip 包管理器

安装

选项1：使用 uvx （建议短暂使用）

无需安装。您可以直接使用以下命令运行服务器 uvx.

uvx --from office-word-mcp-server word_mcp_server

选项2：本地安装

克隆存储库并安装依赖项：

git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server
pip install -r requirements.txt

集成指南

亚马逊Q开发人员（VS代码/JetBrains）

要将Office Word MCP与Amazon Q Developer集成，请执行以下操作：

  1. 打开IDE设置并导航到 亚马逊Q > MCP服务器.
  2. 添加新的服务器配置：
    • 名字: word-automation
    • 命令: uvx
    • 参数: --from, office-word-mcp-server, word_mcp_server
  3. 重新启动IDE。Amazon Q现在可以访问Word工具。

基罗

在Kiro设置或配置文件中配置服务器：

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

其他MCP客户端（克劳德桌面等）

将以下内容添加到MCP配置文件中（例如。， claude_desktop_config.json):

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

API 参考

服务器向AI助手公开以下工具。

核心业务

工具名称 描述
create_document 创建新的空白或基于模板的文档。
get_document_text 从文件中提取所有文本内容。
list_available_documents 扫描目录以查找有效的Word文件。
convert_to_pdf 将.docx导出为PDF格式。

内容和格式

工具名称 描述
add_heading 插入结构化标题（1-9级）。
add_paragraph 添加具有样式支持的文本块。
add_table 创建新的表结构。
format_text 将粗体、斜体、颜色等应用于文本范围。

表格管理

工具名称 描述
format_table 将样式、边框和着色应用于表格。
merge_table_cells 水平或垂直合并单元格。
set_table_column_width 精确控制立柱尺寸。

（请参阅中的完整工具列表 word_mcp_server.py 来源）

故障排除

常见问题

权限不足

  • 原因：服务器无法访问文件系统。
  • 修复：确保正在运行的进程具有对目标目录的R/W访问权限。在Windows上，确保该文件未在Microsoft Word中打开。

未应用样式

  • 原因：使用基础模板中不存在的样式名称。
  • 修复：使用 create_custom_style 在使用之前定义样式，或使用标准Word样式（例如“Normal”、“Heading 1”）。

图像插入失败

  • 原因：相对路径可能不明确。
  • 修复：始终使用 绝对路径 对于图像。

调试

设置 MCP_DEBUG 环境变量到 1 要启用详细日志记录，请执行以下操作：

# Windows (PowerShell)
$env:MCP_DEBUG = "1"

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。

为代理时代而建。

相关 MCP