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 или по-нов. Инсталирайте сървъра във виртуална среда; първият пакет е споделената библиотека за файлови инструменти, от която зависят всички 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"
}
}
}
}// Same JSON shape as VS Code above — use the config path for your tool: // ~/.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
|
| подсказка: 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 | ||
Всеки сървър също включва четири споделени файлови инструменти (upload, download, list и delete), така че един сървър е достатъчен за пълен процес на качване, обработка и изтегляне.