Docxprocessor

🚀 Docx MCP Service

A Docx document processing service based on the FastMCP library, enabling the creation, editing, and management of Word documents through the AI assistant in Cursor.

English | Chinese

✨ Features

• Comprehensive Document Operations: Supports creating, opening, and saving documents, as well as adding, editing, and deleting content.
• Formatting Settings: Allows setting font, color, size, alignment, and other formatting options.
• Table Handling: Enables creating, editing, merging, and splitting table cells.
• Image Insertion: Supports inserting images and setting their sizes.
• Layout Control: Allows setting page margins, adding page breaks, and other layout elements.
• Query Function: Supports retrieving document information, paragraph content, and table data.
• Convenient Editing: Supports find and replace functions.
• Section Editing: Supports replacing content in specific sections while preserving the original format and style.

📦 Installation

Ensure that Python 3.10+ is installed, and then install the following dependencies:

pip3 install python-docx mcp

💻 Usage Examples

Using as an MCP Service in Cursor

1. Open Cursor and go to Settings.
2. Navigate to the Features > MCP Servers section.
3. Click Add New MCP Server.
4. Fill in the following information:
   • Name: MCP_DOCX
   • Type: Command
   • Command: python3 /path/to/MCP_dox/server.py (Replace the path with the actual path to your server.py)
5. Click Add to add the service.

After adding the service, you can use natural language to operate Word documents in Cursor's AI assistant, for example:

• "Create a new Word document and save it to the desktop."
• "Add a third-level heading."
• "Insert a 3x4 table and fill in the data."
• "Set the second paragraph to bold and center-align it."

Supported Operations

This service supports the following operations:

• Document Management: create_document, open_document, save_document
• Content Addition: add_paragraph, add_heading, add_table, add_picture
• Content Editing: edit_paragraph, delete_paragraph, delete_text
• Table Operations: add_table_row, delete_table_row, edit_table_cell, merge_table_cells, split_table
• Layout Control: add_page_break, set_page_margins
• Query Function: get_document_info, get_paragraphs, get_tables, search_text
• File Operations: create_document, open_document, save_document, save_as_document, create_document_copy
• Section Editing: replace_content_in_section, preserving the original format and style
• Others: set_header_and_footer, add_watermark

🔧 Technical Details

The service uses python-docx to process Word documents and communicates with the AI assistant through the FastMCP library. It parses user instructions, performs corresponding document operations, and returns the results.

Typesetting Capabilities

• Text Hierarchy: Supports handling different levels of text such as headings and body text.
• Page Layout: Supports setting headers, footers, watermarks, and section breaks.
• Font Style: Supports adjusting font, size, color, and alignment.
• Table Format: Supports adjusting table margins, row height, and column width.
• Page Break Control: Supports adding page breaks and handling odd pages.

Development Considerations

• server.py is the core implementation file, responsible for parsing user instructions and interacting with the document processing logic.
• It supports expansion to meet more advanced requirements.
• Troubleshooting steps are provided to help solve common problems.

Troubleshooting

1. Ensure that the correct Python version (3.10+) is installed.
2. Check if the dependencies are installed correctly.
3. Ensure that the path configuration is correct.
4. Check the console output for more information.

📄 License

This service is licensed under the MIT License, allowing free use and modification.

This document comprehensively introduces the features, installation steps, usage methods, and development considerations of the Docx MCP service. It is a valuable resource for users who want to integrate Word document processing capabilities into Cursor.