Office Word

🚀 Office Word-MCP Server

A server implementing the Model Context Protocol (MCP) for creating, reading, and manipulating Microsoft Word documents. When used in conjunction with Claude for Desktop or other MCP clients, this server enables automated document processing.

🚀 Quick Start

The Office Word - MCP Server is designed to interact with Microsoft Word documents through the Model Context Protocol (MCP). It can be used with MCP clients like Claude for Desktop to automate document - related tasks.

✨ Features

The server, based on the Model Context Protocol (MCP), supports the following functionalities:

• Document Management: Create, read, and manipulate Word documents.
• Content Creation: Add headings, paragraphs, tables, and pictures.
• Text Formatting: Adjust font styles, sizes, colors, etc.
• Table Formatting: Set table borders, backgrounds, and other attributes.

💻 Usage Examples

Here are some examples of the server's functions:

Basic Usage

# Add a heading
add_heading("example.docx", "This is a heading", level=1)

# Add a paragraph
add_paragraph("example.docx", "This is the first paragraph of text.")

# Add a table
add_table("example.docx", 2, 2)

# Adjust text style
format_text("example.docx", 0, 0, 5, bold=True, color="FF0000")

📚 Documentation

Function Details

Document Management

• create_document: Create a new document.
• open_document: Open an existing document.
• save_document: Save the document.
• close_document: Close the document.

Content Creation

• add_heading: Add a heading.
• add_paragraph: Add a paragraph.
• add_table: Add a table.
• add_picture: Insert a picture.
• add_page_break: Insert a page break.

Text Formatting

• format_text: Adjust text styles (e.g., bold, italic, color, etc.).
• search_and_replace: Find and replace text.
• delete_paragraph: Delete a paragraph.

Table Formatting

• format_table: Set table borders, backgrounds, and other attributes.

📦 Installation

System Requirements

• Operating System: Windows, Linux, or macOS.
• Python Version: 3.6+.

Installation Steps

1. Clone the project repository:

git clone https://github.com/your-repository.git

2. Install the dependencies:

pip install python-docx fastmcp

Configuration for Claude for Desktop

1. Open the settings.json file.
2. Add the following configuration:

{
    "mcp_server": "file:///path/to/server.py"
}

3. Start the server and connect to Claude.

📄 API Documentation

Document Management Interfaces

• create_document(path: str) -> None
  • Create a new document with the specified file path.
• open_document(path: str) -> None
  • Open an existing document.
• save_document() -> None
  • Save the current document.

Content Creation Interfaces

• add_heading(text: str, level: int = 1) -> None
  • Add a heading with the specified text and heading level.

🔧 Troubleshooting

Common Issues

1. Missing Styles

• Some documents may lack necessary styles.
• The server will attempt to create missing styles or directly apply formatting.

2. Permission Issues

• Ensure that the server has read and write permissions for the file path.
• Use copy_document to create an editable copy.

🤝 Contribution Guidelines

We welcome Pull Requests!

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the remote repository.
5. Submit a pull request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

⚠️ Important Note

This server interacts with document files. Please ensure that your operations are appropriate before confirming in MCP clients such as Claude for Desktop.