Aspose.words MCP Server
Aspose.Words MCP Server
Installation
npx aspose-words-mcp-serverAsk AI about Aspose.words MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Aspose.words MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Aspose.Words MCP
Overview
Aspose.Words MCP is a FastMCP-based MCP server built on top of Aspose.Words for Python via .NET. It automates Microsoft Word document creation and editing and exposes operations as MCP tools that any MCP-compatible client can call. The server is aligned with Aspose.Words for Python via .NET 26.3.0. Supported transports: stdio, streamable-http, sse.
Features
- Create documents; read/write text, headings, and paragraphs
- Text replacement workflows, including optional run joining when needed
- Text formatting (font, size, style, color, underline)
- Page and section breaks; page setup (margins, orientation, paper size, columns)
- Lists (bulleted/numbered)
- Tables: create, auto-fit, merge cells, alignment, shading, paddings, column widths, header styling
- Footnotes and endnotes: add, convert, anchor-based operations, validation
- Comments: get by author, by paragraph, all comments
- Document properties: read/write (title, author, subject, keywords)
- Protection: protect/unprotect, partial editing restrictions
- Bookmarks, hyperlinks
- Watermarks (text/image)
- Export as Base64 (DOCX, PDF, etc.)
- Render page to image (PNG, etc.)
- In-memory document management: copy, save as, list, delete, merge
Requirements
- Python 3.11+
- Aspose.Words for Python via .Net. This library is a commercial product.
You'll need to obtain a valid license for Aspose.Words. The package will install this dependency, but you're responsible for complying with Aspose's licensing terms.
Installation
pip install aspose-words-mcp
From source (download repo and install requirements):
git clone https://github.com/aspose-words/Aspose.Words-MCP
cd Aspose.Words-MCP
pip install -r requirements.txt
Command Line Interface
After installation, the CLI command is available:
aspose-words-mcp
By default, the server runs with the stdio transport.
Run without installation:
python mcp_server.py
Transports and Configuration
Supported MCP transports: stdio, streamable-http, sse.
Environment Variables
MCP_TRANSPORTβstdio|streamable-http|sse(defaultstdio)MCP_HOSTβ host address (default0.0.0.0)MCP_PORTβ port (default8080)MCP_PATHβ HTTP path forstreamable-http(default/mcp)MCP_SSE_PATHβ events path forsse(default/sse)LOG_LEVELβ logging level (INFO,DEBUG, ...)
Aspose.Words License
The Aspose.Words license is applied when the server starts. The effective path to the license file is resolved with the following precedence:
- The
license_pathargument ofrun_server(..., license_path=None) - The
ASPOSE_WORDS_LICENSE_PATHenvironment variable
If no license is provided or the file is not accessible, the server runs in Evaluation mode.
Example of setting the environment variable:
export ASPOSE_WORDS_LICENSE_PATH='/path/to/aspose.words.lic'
HTTP/SSE Run Example
export MCP_TRANSPORT=streamable-http # or sse
export MCP_HOST=0.0.0.0
export MCP_PORT=8080
export MCP_PATH=/mcp # for streamable-http
export MCP_SSE_PATH=/sse # for sse
aspose-words-mcp
On start, the server prints the listening address.
Tools
See full list and signatures in mcp_server.py (function register_tools) and tests in tests/features/*.
Main tool categories:
- content/reading: create document, insert/delete/read text, headings, lists, HTML/Markdown
- layout: pages, breaks, columns, headers/footers, page numbering
- tables: create and format tables
- watermarks: watermarks
- links/bookmarks: hyperlinks and bookmarks
- properties: document properties
- protection: protection and restrictions
- comments/notes: comments, footnotes/endnotes
- export/render: export (including Docling advanced export), page rendering
Example Workflow via an MCP Client
Sequence of tool calls (names match the server):
create_documentβ getdoc_idadd_heading(e.g., levels 1β3)add_paragraph/insert_text_endadd_table_endoradd_table_at_paragraphadd_watermark_textoradd_watermark_image_base64export_base64(e.g.,fmt="pdf") β get file as Base64
Integration with MCP Clients
- Claude Desktop MCP: add this server with
streamable-httporssetransport and the URL printed by the server at startup. - Any MCP (JSON) clients β configure the matching transport and path.
License
This package is licensed under the MIT License. However, it depends on Aspose.Words for Python via .Net library, which is proprietary, closed-source library.
β οΈ You must obtain valid license for Aspose.Words for Python via .Net library. This repository does not include or distribute any proprietary components.
Trademarks
This project may contain trademarks or logos for projects, products, or services. Use of third-party trademarks or logos is subject to those third-party policies.
