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集成，请执行以下操作：
- 打开IDE设置并导航到 亚马逊Q > MCP服务器.
- 添加新的服务器配置：
- 名字: word-automation - 命令: uvx - 参数: --from, office-word-mcp-server, word_mcp_server
- 重新启动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许可证获得许可。看 许可证 了解详情。
______________________________________________________________________
_为代理时代而建。_