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
Metadata
Release files for iflow-mcp_meterlong-mcp-doc 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_meterlong_mcp_doc-0.1.0.tar.gz | 10.9 kB | Without provenance | Details for iflow_mcp_meterlong_mcp_doc-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_meterlong_mcp_doc-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_meterlong_mcp_doc-0.1.0-py3-none-any.whl |
Total release size: 27.5 kB
Release files / iflow_mcp_meterlong_mcp_doc-0.1.0.tar.gz
| Download URL | iflow_mcp_meterlong_mcp_doc-0.1.0.tar.gz |
|---|---|
| Size | 10.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0982c80213aed226b5f746d0941090cea5e4590713ac4500dc5de418870810b
|
|
BLAKE2b-256 checksum How to use checksums |
367100eaca88d0ccb103918f6e7131c5026d1e8cdeda4cdaaa4260d6fac24384
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_meterlong_mcp_doc-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_meterlong_mcp_doc-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
651fa0da08b8192b65818edf8454643ad243f1d8915bc2945071b1cbae689cd7
|
|
BLAKE2b-256 checksum How to use checksums |
85eedb03e8915015403b1df29517afffd93addc678077a6131229ecf31d4f972
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_meterlong-mcp-doc 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.