Aspose Cloud API
Aspose.Words Cloud MCP Server
Cloud APIWord processing
DOCXDOCRTFODT
发行版 v2.0.1
Convert, create and compare Word documents, replace text, and read bookmarks, comments, properties and statistics, through Aspose.Words Cloud's REST API, from any MCP-compatible AI client.
设置
安装 Aspose.Words Cloud
您需要 Python 3.11 及以上版本。将服务器安装到虚拟环境中；第一个包是所有 Aspose Cloud MCP 服务器依赖的共享文件工具库。
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install \ git+https://github.com/aspose-cloud/aspose-storage-cloud-python-mcp.git@v1.0.5 \ git+https://github.com/aspose-cloud/aspose-words-cloud-python-mcp.git@v2.0.1
这会将 aspose-words-mcp 命令放入虚拟环境中。
在您的 AI 客户端中配置 Aspose.Words Cloud
在 Aspose Cloud 仪表板上创建应用以获取客户端 ID 和客户端密钥（提供免费试用层）。服务器启动时会从其环境读取这些信息；它们永不作为工具参数传递。ASPOSE_FILES_PATH 是服务器可以读取文件并写入结果的本地文件夹。
{
"mcpServers": {
"words": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-words-mcp.exe",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "C:\\Users\\you\\Documents\\aspose-files"
}
}
}
}
// macOS / Linux: "command": "/path/to/.venv/bin/aspose-words-mcp"{
"servers": {
"words": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-words-mcp",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "/home/you/aspose-files"
}
}
}
}// 与上面的 VS Code 相同的 JSON 结构 —— 使用工具的配置路径： // ~/.cursor/mcp.json · Cline 设置 · Windsurf mcp_config.json
试用
示例提示
- Upload report.docx, convert it to PDF and download the result.
- How many pages and words does contract.docx have?
- In proposal.docx replace every "Acme Ltd" with "Acme Inc" and save the result as proposal-v2.docx.
- List the comments and bookmarks in review-draft.docx.
参考
可用工具 (11)
此服务器公开的每个工具，都直接源自其工具清单。
| 工具 | 描述 | 参数 |
|---|---|---|
words_get_document_bookmarks |
Retrieves the list of bookmarks and their common information from a specified Word document stored in Aspose Cloud. 只读 |
filename: str（必需）, folder_name: str | None, storage_name: str | None
|
| 提示：list the bookmarks in contract.docx using aspose words cloud mcp | ||
| 提示：list the bookmarks in contract.docx from the legal folder of my MyStorage storage using aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. 只读 |
name: str（必需）, folder: str | None, storage: str | None, load_encoding: str | None
|
| 提示：show all comments in review-draft.docx using aspose words cloud mcp | ||
| 提示：show all comments in review-draft.docx from the reviews folder, reading it as utf-8, using aspose words cloud mcp | ||
| 提示：show all comments in review-draft.docx from my MyStorage storage using aspose words cloud mcp | ||
words_compare_document |
Compares a source Word document with another document and produces a new file that highlights the differences. 演练模式 |
filename: str（必需）, compare_request: dict[str, Any]（必需）, folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| 提示：compare contract-v1.docx with contract-v2.docx and save the highlighted differences as contract-diff.docx using aspose words cloud mcp | ||
| 提示：preview comparing draft.docx with final.docx, without saving anything, using dry run, using aspose words cloud mcp | ||
words_download_document |
Exports a document stored in Aspose Cloud to the specified output format, optionally saving the result to a given path. 只读 |
filename: str（必需）, target_format: str（必需）, folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| 提示：download report.docx from cloud storage as a pdf using aspose words cloud mcp | ||
| 提示：export notes.docx as html and save it as notes.html in the exports folder using aspose words cloud mcp | ||
| 提示：export summary.docx from the reports folder as pdf and return it as base64 text instead of saving it, using aspose words cloud mcp | ||
words_convert_to_format |
Converts a supplied document to a specified format and returns the converted file (or saves it to a given storage path). 只读 |
document_filename: str（必需）, target_format: str（必需）, storage_name: str | None, output_path: str | None, source_filename_hint: str | None, content_base64: str | None, output_filename: str | None, return_base64: bool
|
| 提示：convert report.docx to pdf using aspose words cloud mcp | ||
| 提示：convert letter.rtf to docx and save it as letter.docx in the converted folder using aspose words cloud mcp | ||
| 提示：convert this base64 content, which is a docx file named report.docx, to pdf and return the result as base64 using aspose words cloud mcp | ||
words_save_document_as |
Save a Cloud-stored Word document in another format via explicit save options 演练模式 |
filename: str（必需）, save_options: dict[str, Any]（必需）, folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| 提示：save proposal.docx as a pdf named proposal-final.pdf using aspose words cloud mcp | ||
| 提示：do a dry run of saving brochure.docx as pdf using the fonts in the my-fonts folder, using aspose words cloud mcp | ||
| 提示：save legacy.docx from the archive folder as pdf, reading it as utf-8, using aspose words cloud mcp | ||
words_get_document_properties |
Retrieves the full set of document properties from a Word file stored in Aspose Cloud. 只读 |
filename: str（必需）, folder_name: str | None, storage_name: str | None
|
| 提示：show the document properties of report.docx using aspose words cloud mcp | ||
| 提示：show the document properties of report.docx from the reports folder of my MyStorage storage using aspose words cloud mcp | ||
words_get_available_fonts |
Retrieves the list of fonts that are available for processing Aspose.Words documents. 只读 |
fonts_location: str | None
|
| 提示：list the fonts available for processing documents using aspose words cloud mcp | ||
| 提示：list the fonts available in the my-fonts folder using aspose words cloud mcp | ||
words_get_document_statistics |
Retrieves statistical information (e.g., word, character, paragraph, and page counts) for a specified Word document stored in Aspose Cloud. 只读 |
filename: str（必需）, folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| 提示：how many pages, words and paragraphs does thesis.docx have? use aspose words cloud mcp | ||
| 提示：count the words in thesis.docx including comments, footnotes and text in shapes, using aspose words cloud mcp | ||
words_replace_text |
Replaces all occurrences of a specified text pattern in a Word document stored in Aspose Cloud and optionally saves the modified document under a new name. 演练模式 |
filename: str（必需）, replace_request: dict[str, Any]（必需）, folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, revision_author: str | None, revision_date_time: str | None, dry_run: bool
|
| 提示：replace 'Acme Ltd' with 'Acme Inc' in proposal.docx and save as proposal-v2.docx using aspose words cloud mcp | ||
| 提示：replace 'draft' with 'final' in handbook.docx as a tracked change by author 'Jane Doe' dated 2026-10-23T09:00:00Z using aspose words cloud mcp | ||
| 提示：do a dry run of replacing 2025 with 2026 in handbook.docx from the hr folder, reading it as utf-8, using aspose words cloud mcp | ||
words_create_document |
Creates a new Word document in Aspose Cloud storage with a filename and format inferred from its extension. 演练模式 |
storage_name: str | None, filename: str | None, folder_name: str | None, dry_run: bool
|
| 提示：create a new empty document called meeting-notes.docx using aspose words cloud mcp | ||
| 提示：create a new empty document called minutes.docx in the meetings folder of my MyStorage storage using aspose words cloud mcp | ||
| 提示：do a dry run of creating a new document called agenda.docx using aspose words cloud mcp | ||
每个服务器还内置四个共享文件工具（上传、下载、列出和删除），因此单个服务器即可完成完整的上传、处理、下载工作流。
探索更多