用于Microsoft Word编辑的MCP服务器

此服务器提供与Microsoft Word（.docx）文件交互的工具，并能够将它们精确转换为PDF格式。

这是一个基于TypeScript的MCP服务器，展示了核心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，以获取调试工具。