Aspose.Words Cloud MCP Server
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 или новее. Установите сервер в виртуальное окружение; первый пакет — это общая библиотека file-tool, от которой зависит каждый 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 в виртуальное окружение.
Настройте Aspose.Words Cloud в вашем AI‑клиенте
Создайте приложение в панели Aspose Cloud, чтобы получить Client ID и Client Secret (доступен бесплатный тариф оценки). Сервер читает их из своей среды при запуске; они никогда не передаются как аргумент инструмента. 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"
}
}
}
}// Такая же JSON‑структура, как у VS Code выше — используйте путь конфигурации для вашего инструмента: // ~/.cursor/mcp.json · Cline settings · 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 (required), folder_name: str | None, storage_name: str | None
|
| запрос: вывести список закладок в документе contract.docx с помощью aspose words cloud mcp | ||
| запрос: вывести список закладок в документе contract.docx из папки legal хранилища MyStorage с помощью aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. Только чтение |
name: str (required), folder: str | None, storage: str | None, load_encoding: str | None
|
| запрос: показать все комментарии в документе review-draft.docx с помощью aspose words cloud mcp | ||
| запрос: показать все комментарии в документе review-draft.docx из папки reviews, читая его как utf-8, с помощью aspose words cloud mcp | ||
| запрос: показать все комментарии в документе review-draft.docx из моего хранилища MyStorage с помощью 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 (required), compare_request: dict[str, Any] (required), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| запрос: сравнить contract-v1.docx с contract-v2.docx и сохранить выделенные различия как contract-diff.docx с помощью aspose words cloud mcp | ||
| запрос: просмотреть сравнение draft.docx с final.docx без сохранения, используя dry run, с помощью 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 (required), target_format: str (required), folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| запрос: скачать report.docx из облачного хранилища как pdf с помощью aspose words cloud mcp | ||
| запрос: экспортировать notes.docx как html и сохранить как notes.html в папке exports с помощью aspose words cloud mcp | ||
| запрос: экспортировать summary.docx из папки reports как pdf и вернуть его как base64‑текст вместо сохранения, с помощью 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 (required), target_format: str (required), storage_name: str | None, output_path: str | None, source_filename_hint: str | None, content_base64: str | None, output_filename: str | None, return_base64: bool
|
| запрос: конвертировать report.docx в pdf с помощью aspose words cloud mcp | ||
| запрос: конвертировать letter.rtf в docx и сохранить как letter.docx в папке converted с помощью aspose words cloud mcp | ||
| запрос: конвертировать это base64‑содержимое, которое является файлом report.docx, в pdf и вернуть результат как base64 с помощью aspose words cloud mcp | ||
words_save_document_as |
Save a Cloud-stored Word document in another format via explicit save options Тестовый запуск |
filename: str (required), save_options: dict[str, Any] (required), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| запрос: сохранить proposal.docx как pdf с именем proposal-final.pdf с помощью aspose words cloud mcp | ||
| запрос: выполнить dry run сохранения brochure.docx как pdf, используя шрифты из папки my-fonts, с помощью aspose words cloud mcp | ||
| запрос: сохранить legacy.docx из папки archive как pdf, читая его как utf-8, с помощью 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 (required), folder_name: str | None, storage_name: str | None
|
| запрос: показать свойства документа report.docx с помощью aspose words cloud mcp | ||
| запрос: показать свойства документа report.docx из папки reports моего хранилища MyStorage с помощью 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
|
| запрос: вывести список доступных шрифтов для обработки документов с помощью aspose words cloud mcp | ||
| запрос: вывести список доступных шрифтов в папке my-fonts с помощью 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 (required), folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| запрос: сколько страниц, слов и абзацев в файле thesis.docx? использовать aspose words cloud mcp | ||
| запрос: подсчитать слова в thesis.docx, включая комментарии, сноски и текст в фигурах, используя 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 (required), replace_request: dict[str, Any] (required), 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
|
| запрос: заменить 'Acme Ltd' на 'Acme Inc' в файле proposal.docx и сохранить как proposal-v2.docx с помощью aspose words cloud mcp | ||
| запрос: заменить 'draft' на 'final' в файле handbook.docx как отслеживаемое изменение автором 'Jane Doe' от 2026-10-23T09:00:00Z с помощью aspose words cloud mcp | ||
| запрос: выполнить dry run замены 2025 на 2026 в handbook.docx из папки hr, читая его как utf-8, с помощью 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
|
| запрос: создать новый пустой документ под именем meeting-notes.docx с помощью aspose words cloud mcp | ||
| запрос: создать новый пустой документ под именем minutes.docx в папке meetings моего хранилища MyStorage с помощью aspose words cloud mcp | ||
| запрос: выполнить dry run создания нового документа под именем agenda.docx с помощью aspose words cloud mcp | ||
Каждый сервер также включает четыре общих файловых инструмента (upload, download, list и delete), поэтому один сервер достаточен для полного рабочего процесса загрузки, обработки и скачивания.