Aspose.Words Cloud Servidor 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.
Instalar Aspose.Words Cloud
Necesitas Python 3.11 o superior. Instala el servidor en un entorno virtual; el primer paquete es la biblioteca compartida de herramientas de archivo de la que depende cada servidor MCP de Aspose Cloud.
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
Esto coloca el comando aspose-words-mcp dentro del entorno virtual.
Configura Aspose.Words Cloud en tu cliente IA
Crea una aplicación en tu panel de Aspose Cloud para obtener un Client ID y un Client Secret (hay un nivel de evaluación gratuito disponible). El servidor los lee de su entorno al iniciarse; nunca se pasan como argumento de herramienta. ASPOSE_FILES_PATH es la carpeta en tu ordenador desde la que el servidor puede leer archivos y a la que puede escribir resultados.
{
"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"
}
}
}
}// La misma estructura JSON que VS Code arriba — usa la ruta de configuración para tu herramienta: // ~/.cursor/mcp.json · Configuración de Cline · Windsurf mcp_config.json
Ejemplos de prompts
- 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.
Herramientas disponibles (11)
Cada herramienta que expone este servidor, directamente desde su propio manifiesto de herramientas.
| Herramienta | Descripción | Parámetros |
|---|---|---|
words_get_document_bookmarks |
Retrieves the list of bookmarks and their common information from a specified Word document stored in Aspose Cloud. Solo lectura |
filename: str (requerido), folder_name: str | None, storage_name: str | None
|
| prompt: lista los marcadores en contract.docx usando aspose words cloud mcp | ||
| prompt: lista los marcadores en contract.docx desde la carpeta legal de mi MyStorage storage usando aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. Solo lectura |
name: str (requerido), folder: str | None, storage: str | None, load_encoding: str | None
|
| prompt: muestra todos los comentarios en review-draft.docx usando aspose words cloud mcp | ||
| prompt: muestra todos los comentarios en review-draft.docx desde la carpeta reviews, leyéndolo como utf-8, usando aspose words cloud mcp | ||
| prompt: muestra todos los comentarios en review-draft.docx de mi MyStorage storage 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. Ejecución de prueba |
filename: str (requerido), compare_request: dict[str, Any] (requerido), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| prompt: compara contract-v1.docx con contract-v2.docx y guarda las diferencias resaltadas como contract-diff.docx usando aspose words cloud mcp | ||
| prompt: previsualiza la comparación entre draft.docx y final.docx, sin guardar nada, usando modo de prueba, 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. Solo lectura |
filename: str (requerido), target_format: str (requerido), folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| prompt: descarga report.docx del almacenamiento en la nube como pdf usando aspose words cloud mcp | ||
| prompt: exporta notes.docx como html y guárdalo como notes.html en la carpeta exports usando aspose words cloud mcp | ||
| prompt: exporta summary.docx de la carpeta reports como pdf y devuélvelo como texto base64 en lugar de guardarlo, 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). Solo lectura |
document_filename: str (requerido), target_format: str (requerido), 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: convierte report.docx a pdf usando aspose words cloud mcp | ||
| prompt: convierte letter.rtf a docx y guárdalo como letter.docx en la carpeta converted usando aspose words cloud mcp | ||
| prompt: convierte este contenido base64, que es un archivo docx llamado report.docx, a pdf y devuelve el resultado como base64 usando aspose words cloud mcp | ||
words_save_document_as |
Save a Cloud-stored Word document in another format via explicit save options Ejecución de prueba |
filename: str (requerido), save_options: dict[str, Any] (requerido), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| prompt: guarda proposal.docx como pdf llamado proposal-final.pdf usando aspose words cloud mcp | ||
| prompt: realiza una ejecución de prueba de guardar brochure.docx como pdf usando las fuentes en la carpeta my-fonts, usando aspose words cloud mcp | ||
| prompt: guarda legacy.docx de la carpeta archive como pdf, leyéndolo como 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. Solo lectura |
filename: str (requerido), folder_name: str | None, storage_name: str | None
|
| prompt: muestra las propiedades del documento report.docx usando aspose words cloud mcp | ||
| prompt: muestra las propiedades del documento report.docx de la carpeta reports de mi MyStorage storage usando aspose words cloud mcp | ||
words_get_available_fonts |
Retrieves the list of fonts that are available for processing Aspose.Words documents. Solo lectura |
fonts_location: str | None
|
| prompt: lista las fuentes disponibles para procesar documentos usando aspose words cloud mcp | ||
| prompt: lista las fuentes disponibles en la carpeta 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. Solo lectura |
filename: str (requerido), folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| prompt: ¿cuántas páginas, palabras y párrafos tiene thesis.docx? usa aspose words cloud mcp | ||
| prompt: cuenta las palabras en thesis.docx incluidas los comentarios, notas a pie y texto en formas, 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. Ejecución de prueba |
filename: str (requerido), replace_request: dict[str, Any] (requerido), 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: reemplaza 'Acme Ltd' con 'Acme Inc' en proposal.docx y guárdalo como proposal-v2.docx usando aspose words cloud mcp | ||
| prompt: reemplaza 'draft' con 'final' en handbook.docx como cambio controlado por el autor 'Jane Doe' con fecha 2026-10-23T09:00:00Z usando aspose words cloud mcp | ||
| prompt: realiza una ejecución de prueba de reemplazar 2025 con 2026 en handbook.docx de la carpeta hr, leyéndolo como 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. Ejecución de prueba |
storage_name: str | None, filename: str | None, folder_name: str | None, dry_run: bool
|
| prompt: crea un nuevo documento vacío llamado meeting-notes.docx usando aspose words cloud mcp | ||
| prompt: crea un nuevo documento vacío llamado minutes.docx en la carpeta meetings de mi MyStorage storage usando aspose words cloud mcp | ||
| prompt: realiza una ejecución de prueba de crear un nuevo documento llamado agenda.docx usando aspose words cloud mcp | ||
Cada servidor también incluye cuatro herramientas de archivo compartidas (subir, descargar, listar y eliminar), por lo que un solo servidor basta para un flujo completo de subir, procesar y descargar.