使用说明

项目简介

Office Word MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它充当 AI 助手与 Microsoft Word 文档之间的桥梁。通过这个服务器,AI 助手可以利用一系列工具和资源,以标准化的方式操作 Word 文档,实现文档的创建、内容编辑、格式调整和信息提取等功能。

主要功能点

  • 文档管理: 创建新的 Word 文档,复制文档,列出指定目录下的文档,获取文档属性和结构信息。
  • 内容创作: 在文档中添加标题、段落、表格、图片和分页符。
  • 富文本格式化: 对文档中的文本进行字体、颜色、粗体、斜体、下划线等格式设置,支持查找和替换文本。
  • 表格格式化: 设置表格边框、标题行样式和单元格底纹等。
  • 高级文档操作: 删除段落,创建和应用自定义文档样式,对指定范围的文本进行精细格式控制。

安装步骤

  1. 克隆仓库

    git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
    cd Office-Word-MCP-Server
  2. 安装依赖

    推荐使用 'setup_mcp.py' 脚本进行安装,它会自动创建虚拟环境并安装所有必要的依赖:

    python setup_mcp.py

    或者,您也可以手动安装依赖:

    pip install -r requirements.txt

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用,例如 Claude for Desktop。以下是两种配置方式,请根据您的实际情况选择:

方法 1: 本地安装后配置

如果您已按照安装步骤在本地安装了 Office Word MCP Server,可以使用以下配置:

{
  "mcpServers": {
    "word-document-server": {
      "command": "python",
      "args": [
        "/path/to/Office-Word-MCP-Server/word_server.py"  // 请替换为 word_server.py 脚本的实际路径
      ]
    }
  }
}
  • 'command': 启动服务器的命令,这里使用 'python' 解释器。
  • 'args': 传递给 'python' 命令的参数,即 'word_server.py' 脚本的绝对路径。请务必替换为实际路径

方法 2: 不安装,使用 uvx 配置

如果您不想在本地完整安装,可以使用 'uvx' 包管理器进行配置(前提是您已安装 'uvx'):

{
  "mcpServers": {
    "word-document-server": {
      "command": "uvx",
      "args": [
        "--from", "office-word-mcp-server", "word_mcp_server"
      ]
    }
  }
}
  • 'command': 启动服务器的命令,这里使用 'uvx'。
  • 'args': 传递给 'uvx' 的参数,指定从 'office-word-mcp-server' 包中运行 'word_mcp_server' 模块。

配置文件的位置

  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

修改配置文件后,重启 Claude for Desktop 使配置生效。

基本使用方法

配置完成后,您可以在 Claude for Desktop 中通过自然语言指令来操作 Word 文档,例如:

  • "创建一个名为 'report.docx' 的新文档,包含标题页"
  • "在我的文档中添加一个标题和三个段落"
  • "插入一个 4x4 的表格,包含销售数据"
  • "将第二段中的 '重要' 这个词设置为粗体和红色"
  • "查找并替换文档中所有 '旧术语' 为 '新术语'"
  • "为节标题创建一个自定义样式"
  • "应用格式到我的文档中的表格"

请注意,服务器操作的是您本地系统上的文档文件,使用时请务必谨慎确认操作内容。

信息

分类

生产力应用