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.
Instalar Aspose.Words Cloud
Você precisa do Python 3.11 ou superior. Instale o servidor em um ambiente virtual; o primeiro pacote é a biblioteca compartilhada de ferramentas de arquivos da qual todo servidor MCP Aspose Cloud depende.
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
Isso coloca o comando aspose-words-mcp no ambiente virtual.
Configure Aspose.Words Cloud no seu cliente AI
Crie uma aplicação no seu painel Aspose Cloud para obter um Client ID e um Client Secret (há um nível de avaliação gratuito disponível). O servidor os lê do seu ambiente ao iniciar; eles nunca são passados como argumento de ferramenta. ASPOSE_FILES_PATH é a pasta no seu computador da qual o servidor pode ler arquivos e para a qual pode gravar 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"
}
}
}
}// Mesmo formato JSON que o VS Code acima — use o caminho de config para sua ferramenta: // ~/.cursor/mcp.json · Cline settings · Windsurf mcp_config.json
Prompts de exemplo
- 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.
Ferramentas disponíveis (11)
Cada ferramenta que este servidor expõe, diretamente de seu próprio manifesto de ferramentas.
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
words_get_document_bookmarks |
Retrieves the list of bookmarks and their common information from a specified Word document stored in Aspose Cloud. Somente leitura |
filename: str (obrigatório), folder_name: str | None, storage_name: str | None
|
| prompt: listar os marcadores em contract.docx usando aspose words cloud mcp | ||
| prompt: listar os marcadores em contract.docx da pasta legal do meu armazenamento MyStorage usando aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. Somente leitura |
name: str (obrigatório), folder: str | None, storage: str | None, load_encoding: str | None
|
| prompt: exibir todos os comentários em review-draft.docx usando aspose words cloud mcp | ||
| prompt: exibir todos os comentários em review-draft.docx da pasta reviews, lendo como utf-8, usando aspose words cloud mcp | ||
| prompt: exibir todos os comentários em review-draft.docx do meu armazenamento 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. Execução simulada |
filename: str (obrigatório), compare_request: dict[str, Any] (obrigatório), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| prompt: comparar contract-v1.docx com contract-v2.docx e salvar as diferenças destacadas como contract-diff.docx usando aspose words cloud mcp | ||
| prompt: visualizar a comparação entre draft.docx e final.docx, sem salvar nada, usando execução a seco, 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. Somente leitura |
filename: str (obrigatório), target_format: str (obrigatório), folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| prompt: baixar report.docx do armazenamento em nuvem como pdf usando aspose words cloud mcp | ||
| prompt: exportar notes.docx como html e salvá‑lo como notes.html na pasta exports usando aspose words cloud mcp | ||
| prompt: exportar summary.docx da pasta reports como pdf e retorná‑lo como texto base64 em vez de salvá‑lo, 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). Somente leitura |
document_filename: str (obrigatório), target_format: str (obrigatório), 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: converter report.docx para pdf usando aspose words cloud mcp | ||
| prompt: converter letter.rtf para docx e salvá‑lo como letter.docx na pasta converted usando aspose words cloud mcp | ||
| prompt: converter este conteúdo base64, que é um arquivo docx chamado report.docx, para pdf e retornar o 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 Execução simulada |
filename: str (obrigatório), save_options: dict[str, Any] (obrigatório), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| prompt: salvar proposal.docx como pdf chamado proposal-final.pdf usando aspose words cloud mcp | ||
| prompt: executar uma simulação de salvar brochure.docx como pdf usando as fontes na pasta my-fonts, usando aspose words cloud mcp | ||
| prompt: salvar legacy.docx da pasta archive como pdf, lendo 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. Somente leitura |
filename: str (obrigatório), folder_name: str | None, storage_name: str | None
|
| prompt: exibir as propriedades do documento report.docx usando aspose words cloud mcp | ||
| prompt: exibir as propriedades do documento report.docx da pasta reports do meu armazenamento MyStorage usando aspose words cloud mcp | ||
words_get_available_fonts |
Retrieves the list of fonts that are available for processing Aspose.Words documents. Somente leitura |
fonts_location: str | None
|
| prompt: listar as fontes disponíveis para processar documentos usando aspose words cloud mcp | ||
| prompt: listar as fontes disponíveis na pasta 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. Somente leitura |
filename: str (obrigatório), folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| prompt: quantas páginas, palavras e parágrafos tem thesis.docx? use aspose words cloud mcp | ||
| prompt: contar as palavras em thesis.docx incluindo comentários, notas de rodapé e texto em 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. Execução simulada |
filename: str (obrigatório), replace_request: dict[str, Any] (obrigatório), 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: substituir 'Acme Ltd' por 'Acme Inc' em proposal.docx e salvar como proposal-v2.docx usando aspose words cloud mcp | ||
| prompt: substituir 'draft' por 'final' em handbook.docx como alteração rastreada pelo autor 'Jane Doe' datada 2026-10-23T09:00:00Z usando aspose words cloud mcp | ||
| prompt: executar uma simulação de substituir 2025 por 2026 em handbook.docx da pasta hr, lendo 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. Execução simulada |
storage_name: str | None, filename: str | None, folder_name: str | None, dry_run: bool
|
| prompt: criar um novo documento vazio chamado meeting-notes.docx usando aspose words cloud mcp | ||
| prompt: criar um novo documento vazio chamado minutes.docx na pasta meetings do meu armazenamento MyStorage usando aspose words cloud mcp | ||
| prompt: executar uma simulação de criar um novo documento chamado agenda.docx usando aspose words cloud mcp | ||
Cada servidor também inclui quatro ferramentas de arquivos compartilhadas (upload, download, list e delete), portanto um único servidor basta para um fluxo completo de upload, processamento e download.