API Aspose Cloud

Aspose.Words Cloud MCP Server

Cloud APIWord processing DOCXDOCRTFODT Release v2.0.1

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.

Configuração

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"
Experimente

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.
Referência

Ferramentas disponíveis (11)

Cada ferramenta que este servidor expõe, diretamente de seu próprio manifesto de ferramentas.

FerramentaDescriçãoParâ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.