mcp-doc
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文件,支持完整的格式设置功能。在编辑内容时能够保留原始样式和格式,实现精确的文档操作。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/meterlong--mcp-doc)HTML
<a href="/listings/meterlong--mcp-doc"><img src="/api/listings/meterlong--mcp-doc/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Ensure Python 3.10+ is installed, then install the following dependencies:
pip3 install python-docx mcp
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 100 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Docx MCP Service
- [English](README.md) | [中文](README_ZH.md)
- [](https://smithery.ai/server/@MeterLong/mcp-doc)
- 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
- 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:
- - Name: MCP_DOCX
- - Type: Command
- - Command: `python3 /path/to/MCP_dox/server.py` (replace with the actual path to your `server.py`)
- 5. 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
- 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
- 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:
- 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.