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，以獲取調試工具。