Docx MCP Service
A Docx document processing service based on the FastMCP library, supporting the creation, editing, and management of Word documents using AI assistants in Cursor.
Features
- Complete Document Operations: Support for creating, opening, saving documents, as well as adding, editing, and deleting content
- Formatting: Support for setting fonts, colors, sizes, alignment, and other formatting options
- Table Processing: Support for creating, editing, merging, and splitting table cells
- Image Insertion: Support for inserting images and setting their sizes
- Layout Control: Support for setting page margins, adding page breaks, and other layout elements
- Query Functions: Support for retrieving document information, paragraph content, and table data
- Convenient Editing: Support for find and replace functionality
- Section Editing: Support for replacing content in specific sections while preserving original formatting and styles
Installation Dependencies
Ensure Python 3.10+ is installed, then install the following dependencies:
pip3 install python-docx mcp
Usage
Using as an MCP Service in Cursor
- Open Cursor and go to Settings
- Find the
Features > MCP Serverssection - Click
Add new MCP server - Fill in the following information:
- Name: MCP_DOCX
- Type: Command
- Command:
python3 /path/to/MCP_dox/server.py(replace with the actual path to yourserver.py)
- Click
Addto add the service
After adding, 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 level 3 heading"
- "Insert a 3x4 table and fill it with data"
- "Set the second paragraph to bold and center-aligned"
Supported Operations
The 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 Functions:
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_section,edit_section_by_keyword - Other Functions:
find_and_replace,search_and_replace(with preview functionality)
How It Works
- The service uses the Python-docx library to process Word documents
- It implements the MCP protocol through the FastMCP library to communicate with AI assistants
- It processes requests and returns formatted responses
- It supports complete error handling and status reporting
Typography Capabilities
The service has good typography understanding capabilities:
- Text Hierarchy: Support for heading levels (1-9) and paragraph organization
- Page Layout: Support for page margin settings
- Visual Elements: Support for font styles (bold, italic, underline, color) and alignment
- Table Layout: Support for creating tables, merging cells, splitting tables, and setting table formats
- Pagination Control: Support for adding page breaks
Development Notes
server.py- Core implementation of the MCP service using the FastMCP library
Troubleshooting
If you encounter problems in Cursor, try the following steps:
- Ensure Python 3.10+ is correctly installed
- Ensure the python-docx and mcp libraries are correctly installed
- Check if the server path is correct
- Restart the Cursor application
Notes
- Ensure the python-docx and mcp libraries are correctly installed
- Ensure Chinese characters in paths can be correctly processed
- Using absolute paths can avoid path parsing issues
License
MIT License