AI-Powered Word Document Processing Service

Overview

The AI-Powered Word Document Processing Service is a powerful tool based on the FastMCP library, enabling AI assistants to create, edit, and manage .docx files with full formatting support. It preserves original styles and formatting while editing content, making it ideal for precise document operations.

Features

• Complete Document Operations: Create, open, save documents, and manage content.
• Formatting: Set fonts, colors, sizes, alignment, and other formatting options.
• Table Processing: Create, edit, merge, and split table cells.
• Image Insertion: Insert images and set their sizes.
• Layout Control: Set page margins, add page breaks, and manage layout elements.
• Query Functions: Retrieve document information, paragraph content, and table data.
• Convenient Editing: Find and replace functionality.
• Section Editing: Replace content in specific sections while preserving original formatting.

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

1. Open Cursor and go to Settings.
2. Find the Features > MCP Servers section.
3. Click Add new MCP server.
4. Fill in the following information:
5. Name: MCP_DOCX
6. Type: Command
7. Command: python3 /path/to/MCP_dox/server.py (replace with the actual path to server.py).
8. Click Add to add the service.

After adding, you can use natural language to operate Word documents in Cursor's AI assistant. Examples:
- "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

• 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

1. The service uses the python-docx library to process Word documents.
2. It implements the MCP protocol through the FastMCP library to communicate with AI assistants.
3. It processes requests and returns formatted responses.
4. It supports complete error handling and status reporting.

Typography 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:
1. Ensure Python 3.10+ is correctly installed.
2. Ensure the python-docx and mcp libraries are correctly installed.
3. Check if the server path is correct.
4. 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

About

A powerful Word document processing service based on FastMCP, enabling AI assistants to create, edit, and manage .docx files with full formatting support. Preserves original styles when editing content. 基于FastMCP的强大Word文档处理服务，使AI助手能够创建、编辑和管理docx文件，支持完整的格式设置功能。在编辑内容时能够保留原始样式和格式，实现精确的文档操作。