word-mcp-server

🚀 用于Microsoft Word编辑的MCP服务器

本服务器提供了与Microsoft Word（.docx）文件进行交互的工具，能够精准地将其转换为PDF格式，为Word文件处理提供了便捷且高效的解决方案。

🚀 快速开始

此服务器是基于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，请参阅下方的安装部分。

📦 安装指南

1. 安装Node.js依赖项：

npm install

2. 安装LibreOffice（用于Word → PDF转换）：

npm run install-libreoffice

3. 编译服务器：

npm run build

4. 使用带有自动重建功能的开发环境：

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，以获取调试工具。