Docxprocessor

🚀 Docx MCP 服務

Docx MCP 服務是一個基於 FastMCP 庫的 Docx 文檔處理服務，支持通過 Cursor 中的 AI 助手創建、編輯和管理 Word 文檔，為用戶提供便捷的文檔處理體驗。

🚀 快速開始

Docx MCP 服務可讓你在 Cursor 的 AI 助手中輕鬆操作 Word 文檔。按以下步驟添加服務後，就能用自然語言進行如創建新文檔、添加標題、插入表格等操作。

✨ 主要特性

• 完整的文檔操作：支持創建、打開、保存文檔，以及添加、編輯和刪除內容。
• 格式設置：支持設置字體、顏色、大小、對齊方式等格式選項。
• 表格處理：支持創建、編輯、合併和拆分表格單元格。
• 圖片插入：支持插入圖片並設置其大小。
• 版式控制：支持設置頁面邊距、添加頁面斷裂和其他版式元素。
• 查詢功能：支持檢索文檔信息、段落內容和表格數據。
• 方便的編輯：支持查找和替換功能。
• 節編輯：支持在特定部分替換內容，同時保留原始格式和樣式。

📦 安裝指南

確保安裝了 Python 3.10+，然後安裝以下依賴項：

pip3 install python-docx mcp

💻 使用示例

基礎用法

在 Cursor 中作為 MCP 服務使用：

1. 打開 Cursor 並進入設置。
2. 進入 功能 > MCP 服務器 部分。
3. 點擊 添加新的 MCP 服務器。
4. 填寫以下信息：
   • 名稱：MCP_DOCX
   • 類型：命令
   • 命令：python3 /path/to/MCP_dox/server.py（將路徑替換為您實際的 server.py 路徑）
5. 點擊 添加 以添加服務。

添加完成後，您可以在 Cursor 的 AI 助手中使用自然語言操作 Word 文檔，例如：

• "創建一個新的 Word 文檔並保存到桌面"
• "添加一個三級標題"
• "插入一個 3x4 表格並填寫數據"
• "將第二段設置為粗體並居中對齊"

📚 詳細文檔

支持的操作

該服務支持以下操作：

• 文檔管理：create_document, open_document, save_document
• 內容添加：add_paragraph, add_heading, add_table, add_picture
• 內容編輯：edit_paragraph, delete_paragraph, delete_text
• 表格操作：add_table_row, delete_table_row, edit_table_cell, merge_table_cells, split_table
• 版式控制：add_page_break, set_page_margins
• 查詢功能：get_document_info, get_paragraphs, get_tables, search_text
• 文件操作：create_document, open_document, save_document, save_as_document, create_document_copy
• 節編輯：replace_content_in_section，保留原始格式和樣式
• 其他：set_header_and_footer, add_watermark

排版能力

• 文本層次：支持處理標題、正文等不同層次的文本。
• 頁面佈局：支持設置頁眉、頁腳、水印和分節符。
• 字體樣式：支持調整字體、字號、顏色和對齊方式。
• 表格格式：支持調整表格邊距、行高和列寬。
• 分頁控制：支持添加分頁符並處理奇數頁。

🔧 技術細節

服務使用 Python-docx 處理 Word 文檔，並通過 FastMCP 庫與 AI 助手通信。它解析用戶指令，執行相應的文檔操作，並返回結果。server.py 是核心實現文件，負責解析用戶指令並與文檔處理邏輯交互。該服務支持擴展以滿足更多高級需求，同時提供了故障排除步驟以幫助解決常見問題。

📄 許可證

該服務採用 MIT License，允許自由使用和修改。

⚠️ 重要提示

在使用服務前，請確保安裝了正確的 Python 版本（3.10+），檢查依賴項是否正確安裝，確保路徑配置正確，若遇到問題可查看控制檯輸出獲取更多信息。

💡 使用建議

若需要更多高級功能，可對服務進行擴展開發。在操作過程中，可充分利用支持的自然語言指令，提高文檔處理效率。