Aspose.Words Cloud MCP сервер
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 (обов’язково), folder_name: str | None, storage_name: str | None
|
| запит: перелічити закладки у файлі contract.docx using aspose words cloud mcp | ||
| запит: перелічити закладки у файлі 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
|
| запит: показати всі коментарі у файлі review-draft.docx using aspose words cloud mcp | ||
| запит: показати всі коментарі у файлі review-draft.docx from the reviews folder, reading it as utf-8, using aspose words cloud mcp | ||
| запит: показати всі коментарі у файлі 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
|
| запит: порівняти contract-v1.docx з contract-v2.docx і зберегти виділені відмінності у contract-diff.docx using aspose words cloud mcp | ||
| запит: показати попередній перегляд порівняння draft.docx з final.docx, без збереження, використовуючи 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
|
| запит: завантажити report.docx з хмарного сховища у формат pdf using aspose words cloud mcp | ||
| запит: експортувати notes.docx у формат html і зберегти як notes.html у папці exports using aspose words cloud mcp | ||
| запит: експортувати summary.docx з папки reports у формат pdf і повернути його як base64‑текст замість збереження, 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
|
| запит: конвертувати report.docx у pdf using aspose words cloud mcp | ||
| запит: конвертувати letter.rtf у docx і зберегти як letter.docx у папці converted using aspose words cloud mcp | ||
| запит: конвертувати цей base64‑контент, який є файлом report.docx, у pdf і повернути результат у вигляді 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
|
| запит: зберегти proposal.docx у pdf під назвою proposal-final.pdf using aspose words cloud mcp | ||
| запит: виконати dry run збереження brochure.docx у pdf, використовуючи шрифти з папки my-fonts, using aspose words cloud mcp | ||
| запит: зберегти legacy.docx з папки archive у pdf, читаючи його як 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
|
| запит: показати властивості документу report.docx using aspose words cloud mcp | ||
| запит: показати властивості документу 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
|
| запит: перелічити шрифти, доступні для обробки документів using aspose words cloud mcp | ||
| запит: перелічити шрифти, доступні у папці my-fonts 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
|
| запит: скільки сторінок, слів та абзаців у thesis.docx? use aspose words cloud mcp | ||
| запит: порахувати слова у thesis.docx разом із коментарями, виносками та текстом у формах, 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
|
| запит: замінити 'Acme Ltd' на 'Acme Inc' у файлі proposal.docx і зберегти як proposal-v2.docx using aspose words cloud mcp | ||
| запит: замінити 'draft' на 'final' у файлі handbook.docx як відстежувану зміну автором 'Jane Doe' датовану 2026-10-23T09:00:00Z using aspose words cloud mcp | ||
| запит: виконати dry run заміни 2025 на 2026 у handbook.docx з папки hr, читаючи його як 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
|
| запит: створити новий порожній документ під назвою meeting-notes.docx using aspose words cloud mcp | ||
| запит: створити новий порожній документ під назвою minutes.docx у папці meetings мого MyStorage storage using aspose words cloud mcp | ||
| запит: виконати dry run створення нового документу agenda.docx using aspose words cloud mcp | ||
Кожен сервер також містить чотири спільних файлових інструменти (upload, download, list та delete), тому одного сервера достатньо для повного процесу завантаження, обробки та скачування.