Aspose Words MCP Server

Aspose。单词MCP

概述

Aspose。单词MCP 是基于FastMCP的MCP服务器，构建在 Aspose。Python的单词通过。网它自动化了Microsoft Word文档的创建和编辑，并将操作作为MCP工具公开，任何兼容MCP的客户端都可以调用。服务器与Aspose对齐。Python的单词通过。网 26.3.0.支持的传输： stdio, streamable-http, sse.

特性

• 创建文档；读/写文本、标题和段落
• 文本替换工作流程，包括在需要时进行可选的运行连接
• 文本格式（字体、大小、样式、颜色、下划线）
• 分页符和分节符；页面设置（边距、方向、纸张大小、列）
• 列表（项目符号/编号）
• 表格：创建、自动调整、合并单元格、对齐、着色、填充、列宽、页眉样式
• 脚注和尾注：添加、转换、基于锚点的操作、验证
• 评论：按作者、段落、所有评论
• 文档属性：读/写（标题、作者、主题、关键字）
• 保护：保护/取消保护，部分编辑限制
• 书签、超链接
• 水印（文本/图像）
• 导出为Base64格式（DOCX、PDF等）
• 将页面渲染为图像（PNG等）
• 内存文档管理：复制、另存为、列出、删除、合并

需求

• Python 3.11+
• Aspose。Python的单词通过。净.这个图书馆是 商业产品.\

您需要获得Aspose的有效许可证。话。该软件包将安装此依赖项，但您有责任遵守Aspose的许可条款。

安装

pip install aspose-words-mcp

从源代码（下载仓库和安装要求）：

git clone https://github.com/aspose-words/Aspose.Words-MCP
cd Aspose.Words-MCP
pip install -r requirements.txt

命令行界面

安装后，CLI命令可用：

aspose-words-mcp

默认情况下，服务器使用 stdio 运输。

无需安装即可运行：

python mcp_server.py

运输和配置

支持的MCP传输： stdio, streamable-http, sse.

环境变量

• MCP_TRANSPORT — stdio | streamable-http | sse （默认值 stdio)
• MCP_HOST --主机地址（默认 0.0.0.0)
• MCP_PORT --端口（默认 8080)
• MCP_PATH --的HTTP路径 streamable-http （默认值 /mcp)
• MCP_SSE_PATH --事件路径 sse （默认值 /sse)
• LOG_LEVEL --测井水位(INFO, DEBUG, ...)

Aspose。Words许可证

Aspose。服务器启动时应用Words许可证。许可证文件的有效路径按以下优先级解析：

1. 这 license_path 论点 run_server(..., license_path=None)
2. 这 ASPOSE_WORDS_LICENSE_PATH 环境变量

如果没有提供许可证或文件不可访问，服务器将在评估模式下运行。

设置环境变量的示例：

export ASPOSE_WORDS_LICENSE_PATH='/path/to/aspose.words.lic'

HTTP/SSE运行示例

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

启动时，服务器会打印监听地址。

工具

查看完整列表和签名 mcp_server.py （功能 register_tools)和测试 tests/features/*.

主要工具类别：

• 内容/阅读：创建文档、插入/删除/阅读文本、标题、列表、HTML/Markdown
• 布局：页面、换行符、列、页眉/页脚、页码
• 表格：创建表格并设置表格格式
• 水印：水印
• 链接/书签：超链接和书签
• 属性：文档属性
• 保护：保护和限制
• 评论/注释：评论、脚注/尾注
• 导出/渲染：导出（包括文档高级导出），页面渲染

通过MCP客户端的示例工作流

工具调用顺序（名称与服务器匹配）：

1. create_document → get doc_id
2. add_heading （例如，1至3级）
3. add_paragraph / insert_text_end
4. add_table_end 或 add_table_at_paragraph
5. add_watermark_text 或 add_watermark_image_base64
6. export_base64 （例如。， fmt="pdf")--以Base64格式获取文件

与MCP客户端集成

• Claude Desktop MCP：添加此服务器 streamable-http 或 sse 传输和服务器在启动时打印的URL。
• 任何MCP（JSON）客户端——配置匹配的传输和路径。

许可证

此软件包根据MIT许可证获得许可。然而，这取决于Aspose。Python的单词通过。Net库，这是一个专有的闭源库。

⚠️ 您必须获得Aspose的有效许可证。Python的单词通过。网络图书馆。此存储库不包含或分发任何专有组件。

商标

此项目可能包含项目、产品或服务的商标或徽标。使用第三方商标或徽标须遵守这些第三方政策。