Cuongpham2107 Word MCP Server

🚀 Word MCP Server

A Python-based application that allows creating and editing Microsoft Word documents (.docx) via API. This project utilizes FastMCP to build tools for interacting with Word documents.

🚀 Quick Start

✨ Features

The Word MCP Server offers the following features:

1. Create and open Word documents
2. Add and format text
3. Insert images
4. Create tables
5. Manage resources and prompts

📦 Installation

Requirements

• Python 3.12+
• Required libraries:
  • python-docx
  • opencv-python (cv2)
  • numpy
  • FastMCP

Install Libraries

uv venv
source venv/bin/activate
uv pip install .

💻 Usage Examples

Configuration and Startup of LLM

To use the Word MCP Server in conjunction with a Large Language Model (LLM), you need to configure it through a JSON file:

{
  "mcpServers": {
    "word-mcp-server": {
      "command": "/path/to/word-mcp-server/.venv/bin/python3",
      "args": ["/path/to/word-mcp-server/server.py"]
    }
  }
}

Configuration Explanation:

• mcpServers: An object containing the configurations of each MCP server.
• word-mcp-server: The identifier name of the server.
• command: The path to the Python interpreter (usually in a virtual environment).
• args: The parameters for the startup command.

Basic Usage

# Create a new document
create_new_document()

# Add a title
add_heading("Project Report", level=0)

# Add author information
p = add_paragraph("Author: ")
add_run_to_paragraph(p, "Zhang San", bold=True)

# Add a table of contents
add_heading("Table of Contents", level=1)
add_paragraph("1. Introduction")
add_paragraph("2. Content")
add_paragraph("3. Conclusion")

# Add content
add_heading("1. Introduction", level=1)
add_paragraph("This is the project introduction section...")

# Insert an image
add_paragraph("Project schematic diagram:")
add_picture("project_diagram.jpg", width=5.0)

# Create a data table
add_heading("Data Table", level=2)
table = add_table(rows=3, cols=3)
table.cell(0, 0).text = "Data 1"
table.cell(0, 1).text = "Data 2"
table.cell(0, 2).text = "Data 3"
# Continue to add other data...

# Save the document
save_document("project_report.docx")