Word Editing MCP Server

Word Editing MCP Server

此服务提供用于操作 Microsoft Word（.docx）文件并将其转换为 PDF 的工具，可精准保留格式。

这是一个基于 TypeScript 的 MCP 服务，提供用于操作 Word 文件的工具。它通过以下功能展示 MCP 的核心概念：

• 用于读取、修改和删除 Word 文件的工具
• 用于将 Word 文件转换为 PDF（完整保留格式）的工具
• 所有文件和文件夹操作现在都可直接使用绝对路径或相对路径（相对于进程的当前工作目录）。不再存在预先选择工作文件夹的概念。

功能

Word 工具

list_files_in_folder

• 用途：列出指定文件夹中的文件。
• 参数：folderPath（可选，文件夹的绝对路径或相对路径；如果省略，则使用当前工作目录）。

read_word_content

• 用途：读取 Word（.docx）文件的文本内容。
• 参数：filePath（.docx 文件的绝对路径或相对路径）。

replace_word_words

• 用途：替换 Word（.docx）文件中的文字并另存为新文件。
• 参数：
  • filePath（输入文件，绝对路径或相对路径）
  • outputFilePath（输出文件，绝对路径或相对路径）
  • replacements（{from, to} 数组）

delete_word_file

• 用途：删除 Word（.docx）文件。
• 参数：filePath（.docx 文件的绝对路径或相对路径）。

word_to_pdf

• 用途：将 Word（.docx）文件转换为 PDF，并保留所有格式和图片。需要安装 LibreOffice。
• 参数：
  • filePath（输入 .docx 文件，绝对路径或相对路径）
  • outputFilePath（输出 .pdf 文件，绝对路径或相对路径）
• 注意：此工具使用 LibreOffice 的无头模式进行专业级转换。如果未安装 LibreOffice，请参阅下方的安装部分。

完整安装

安装 Node.js 依赖：

npm install

安装 LibreOffice（用于将 Word 转换为 PDF）：

npm run install-libreoffice

编译服务：

npm run build

开发时使用自动重新构建：

npm run watch

在 Claude Desktop 中使用

将以下配置添加到：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Word Editing Server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
      }
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能比较困难。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。