Consistent Docx MCP

🚀 文檔格式轉換 MCP 服務器

這是一個基於 Node.js 和 TypeScript 構建的 MCP (Model-Context Protocol) 服務器，主要為大語言模型 (LLM) 提供一套能保持文檔格式一致的 md-docx 互相轉換工具。項目已打包成可通過 npx 直接運行的命令行工具，真正實現了“開箱即用”。

🚀 快速開始

本服務器可作為獨立命令行工具，通過 npx 在任何兼容 MCP 的客戶端中進行配置，無需手動下載、安裝或編譯。按以下步驟操作：

1. 打開客戶端配置：找到並打開您 MCP 客戶端的配置文件（例如 Claude for Desktop 的 claude_desktop_config.json）。

2. 添加服務器配置：在 mcpServers 對象中，添加以下配置。

   ⚠️ 重要提示

   您必須將 --api-key 的值替換為您自己的真實 API 密鑰。API 密鑰請關注公眾號“偷偷成精的鹹魚”聯繫作者獲取。

   {
     "mcpServers": {
       "doc-converter": {
         "command": "npx",
         "args": [
           "consistent-docx-mcp",
           "--api-key",
           "YOUR-API-KEY-HERE"
         ]
       }
     }
   }
   

   • consistent-docx-mcp：這是您將項目發佈到 npm 倉庫時使用的包名。
   • --api-key：這是向服務器傳遞 API 密鑰的標準方式。請將後面的值替換為您的有效密鑰。

3. 重啟客戶端：保存配置文件，然後完全關閉並重新啟動您的 MCP 客戶端。

現在，客戶端將自動通過 npx 下載並運行此工具，您可以在客戶端中直接調用 docx_to_markdown 和 markdown_to_docx。

✨ 主要特性

docx_to_markdown

• 功能：將一個 .docx 文件本地轉換為純文本 Markdown。
• 描述：讀取指定路徑的 .docx 文件並提取其純文本內容。
• 參數：path (字符串) - 輸入的 .docx 文件的絕對路徑。

markdown_to_docx

• 功能：根據 Markdown 內容和參考樣式，生成一個新的 .docx 文件。
• 描述：將您的 Markdown 文本，按照一個參考 .docx 文件的樣式，生成一個格式一致的新文檔。
• 參數：
  • markdown (字符串) - 要轉換的 Markdown 內容。
  • referencePath (字符串) - 作為樣式模板的 .docx 文件的絕對路徑。
  • outputPath (字符串) - 生成的 .docx 文件要保存到的絕對路徑。

📚 詳細文檔