Cuongpham2107 Word MCP Server

🚀 词 Word MCP 服务器

词 Word MCP 服务器是一款基于 Python 的应用程序，它借助 API 实现了对 Microsoft Word 文档（.docx）的创建与编辑功能。该项目运用 FastMCP 构建了与 Word 文档交互的工具。

🚀 快速开始

词 Word MCP 服务器可帮助你轻松创建和编辑 Word 文档。以下将为你介绍其安装、功能及使用方法。

✨ 主要特性

Word MCP 服务器具备以下实用功能：

1. 能够创建和打开 Word 文档。
2. 支持添加和格式化文本。
3. 可插入图片，丰富文档内容。
4. 能创建表格，清晰呈现数据。
5. 可以管理资源和提示。

📦 安装指南

要求

• Python 3.12 及以上版本。
• 所需库：
  • python-docx
  • opencv-python (cv2)
  • numpy
  • FastMCP

安装库

uv venv
source venv/bin/activate
uv pip install .

💻 使用示例

基础用法

要使用 Word MCP 服务器与大语言模型 (LLM) 结合，需通过 JSON 文件进行配置：

{
  "mcpServers": {
    "word-mcp-server": {
      "command": "/path/to/word-mcp-server/.venv/bin/python3",
      "args": ["/path/to/word-mcp-server/server.py"]
    }
  }
}

配置说明：

• mcpServers：包含各 MCP 服务器的配置对象。
• word-mcp-server：服务器的标识名称。
• command：Python 解释器路径（通常位于虚拟环境中）。
• args：启动命令参数。

高级用法

以下是一个完整示例，展示了如何使用 Word MCP 服务器创建一个完整的项目报告文档：

# 创建新文档
create_new_document()

# 添加标题
add_heading("项目报告", level=0)

# 添加创建人信息
p = add_paragraph("作者：")
add_run_to_paragraph(p, "张三", bold=True)

# 添加目录
add_heading("目录", level=1)
add_paragraph("1. 引言")
add_paragraph("2. 内容")
add_paragraph("3. 结论")

# 添加内容
add_heading("1. 引言", level=1)
add_paragraph("这是项目介绍部分...")

# 插入图片
add_paragraph("项目示意图：")
add_picture("project_diagram.jpg", width=5.0)

# 创建数据表格
add_heading("数据表格", level=2)
table = add_table(rows=3, cols=3)
table.cell(0, 0).text = "数据1"
table.cell(0, 1).text = "数据2"
table.cell(0, 2).text = "数据3"
# 继续添加其他数据...

# 保存文档
save_document("project_report.docx")