Docx MCP Service
English | 中文
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:
bash pip3 install python-docx mcp
Usage
Using as an MCP Service in Cursor
- Open Cursor and go to Settings
- Find the
Features > MCP Servers section
- 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 your server.py)
- Click
Add to 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
