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.
Installa Aspose.Words Cloud
È necessario Python 3.11 o successivo. Installa il server in un ambiente virtuale; il primo pacchetto è la libreria condivisa di file-tool da cui dipende ogni server 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
Questo inserisce il comando aspose-words-mcp nell'ambiente virtuale.
Configura Aspose.Words Cloud nel tuo client AI
Crea un'applicazione sulla tua dashboard Aspose Cloud per ottenere un Client ID e un Client Secret (è disponibile un livello di valutazione gratuito). Il server li legge dal suo ambiente all'avvio; non vengono mai passati come argomento di un tool. ASPOSE_FILES_PATH è la cartella sul tuo computer da cui il server può leggere file e scrivere risultati.
{
"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
Prompt di esempio
- 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.
Tool disponibili (11)
Ogni tool esposto da questo server, direttamente dal proprio manifesto dei tool.
| Tool | Descrizione | Parametri |
|---|---|---|
words_get_document_bookmarks |
Retrieves the list of bookmarks and their common information from a specified Word document stored in Aspose Cloud. Sola lettura |
filename: str (obbligatorio), folder_name: str | None, storage_name: str | None
|
| prompt: elenca i segnalibri in contract.docx usando aspose words cloud mcp | ||
| prompt: elenca i segnalibri in contract.docx dalla cartella legal del mio storage MyStorage usando aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. Sola lettura |
name: str (obbligatorio), folder: str | None, storage: str | None, load_encoding: str | None
|
| prompt: mostra tutti i commenti in review-draft.docx usando aspose words cloud mcp | ||
| prompt: mostra tutti i commenti in review-draft.docx dalla cartella reviews, leggendo come utf-8, usando aspose words cloud mcp | ||
| prompt: mostra tutti i commenti in review-draft.docx dal mio storage MyStorage usando aspose words cloud mcp | ||
words_compare_document |
Compares a source Word document with another document and produces a new file that highlights the differences. Esecuzione simulata |
filename: str (obbligatorio), compare_request: dict[str, Any] (obbligatorio), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| prompt: confronta contract-v1.docx con contract-v2.docx e salva le differenze evidenziate come contract-diff.docx usando aspose words cloud mcp | ||
| prompt: anteprima del confronto tra draft.docx e final.docx, senza salvare nulla, usando dry run, usando 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. Sola lettura |
filename: str (obbligatorio), target_format: str (obbligatorio), folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| prompt: scarica report.docx dallo storage cloud come pdf usando aspose words cloud mcp | ||
| prompt: esporta notes.docx come html e salvalo come notes.html nella cartella exports usando aspose words cloud mcp | ||
| prompt: esporta summary.docx dalla cartella reports come pdf e restituiscilo come testo base64 invece di salvarlo, usando 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). Sola lettura |
document_filename: str (obbligatorio), target_format: str (obbligatorio), storage_name: str | None, output_path: str | None, source_filename_hint: str | None, content_base64: str | None, output_filename: str | None, return_base64: bool
|
| prompt: converti report.docx in pdf usando aspose words cloud mcp | ||
| prompt: converti letter.rtf in docx e salvalo come letter.docx nella cartella converted usando aspose words cloud mcp | ||
| prompt: converti questo contenuto base64, che è un file docx chiamato report.docx, in pdf e restituisci il risultato come base64 usando aspose words cloud mcp | ||
words_save_document_as |
Save a Cloud-stored Word document in another format via explicit save options Esecuzione simulata |
filename: str (obbligatorio), save_options: dict[str, Any] (obbligatorio), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| prompt: salva proposal.docx come pdf denominato proposal-final.pdf usando aspose words cloud mcp | ||
| prompt: effettua un dry run di salvataggio di brochure.docx come pdf usando i font nella cartella my-fonts, usando aspose words cloud mcp | ||
| prompt: salva legacy.docx dalla cartella archive come pdf, leggendo come utf-8, usando aspose words cloud mcp | ||
words_get_document_properties |
Retrieves the full set of document properties from a Word file stored in Aspose Cloud. Sola lettura |
filename: str (obbligatorio), folder_name: str | None, storage_name: str | None
|
| prompt: mostra le proprietà del documento report.docx usando aspose words cloud mcp | ||
| prompt: mostra le proprietà del documento report.docx dalla cartella reports del mio storage MyStorage usando aspose words cloud mcp | ||
words_get_available_fonts |
Retrieves the list of fonts that are available for processing Aspose.Words documents. Sola lettura |
fonts_location: str | None
|
| prompt: elenca i font disponibili per l'elaborazione dei documenti usando aspose words cloud mcp | ||
| prompt: elenca i font disponibili nella cartella my-fonts usando 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. Sola lettura |
filename: str (obbligatorio), folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| prompt: quante pagine, parole e paragrafi contiene thesis.docx? usa aspose words cloud mcp | ||
| prompt: conta le parole in thesis.docx includendo commenti, note a piè di pagina e testo nelle forme, usando 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. Esecuzione simulata |
filename: str (obbligatorio), replace_request: dict[str, Any] (obbligatorio), 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
|
| prompt: sostituisci 'Acme Ltd' con 'Acme Inc' in proposal.docx e salva come proposal-v2.docx usando aspose words cloud mcp | ||
| prompt: sostituisci 'draft' con 'final' in handbook.docx come modifica tracciata dall'autore 'Jane Doe' datata 2026-10-23T09:00:00Z usando aspose words cloud mcp | ||
| prompt: effettua un dry run di sostituzione di 2025 con 2026 in handbook.docx dalla cartella hr, leggendo come utf-8, usando 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. Esecuzione simulata |
storage_name: str | None, filename: str | None, folder_name: str | None, dry_run: bool
|
| prompt: crea un nuovo documento vuoto chiamato meeting-notes.docx usando aspose words cloud mcp | ||
| prompt: crea un nuovo documento vuoto chiamato minutes.docx nella cartella meetings del mio storage MyStorage usando aspose words cloud mcp | ||
| prompt: effettua un dry run di creazione di un nuovo documento chiamato agenda.docx usando aspose words cloud mcp | ||
Ogni server include anche quattro tool di file condivisi (upload, download, list e delete), così un singolo server è sufficiente per un flusso completo di upload, elaborazione e download.