Aspose Cloud API

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.

설정

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"
시도해 보기

예시 프롬프트

  • 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
prompt: list the bookmarks in contract.docx using aspose words cloud mcp
prompt: 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
prompt: show all comments in review-draft.docx using aspose words cloud mcp
prompt: show all comments in review-draft.docx from the reviews folder, reading it as utf-8, using aspose words cloud mcp
prompt: 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
prompt: compare contract-v1.docx with contract-v2.docx and save the highlighted differences as contract-diff.docx using aspose words cloud mcp
prompt: 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
prompt: download report.docx from cloud storage as a pdf using aspose words cloud mcp
prompt: export notes.docx as html and save it as notes.html in the exports folder using aspose words cloud mcp
prompt: 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
prompt: convert report.docx to pdf using aspose words cloud mcp
prompt: convert letter.rtf to docx and save it as letter.docx in the converted folder using aspose words cloud mcp
prompt: 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
prompt: save proposal.docx as a pdf named proposal-final.pdf using aspose words cloud mcp
prompt: do a dry run of saving brochure.docx as pdf using the fonts in the my-fonts folder, using aspose words cloud mcp
prompt: 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
prompt: show the document properties of report.docx using aspose words cloud mcp
prompt: 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
prompt: list the fonts available for processing documents using aspose words cloud mcp
prompt: 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
prompt: how many pages, words and paragraphs does thesis.docx have? use aspose words cloud mcp
prompt: 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
prompt: replace 'Acme Ltd' with 'Acme Inc' in proposal.docx and save as proposal-v2.docx using aspose words cloud mcp
prompt: 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
prompt: 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
prompt: create a new empty document called meeting-notes.docx using aspose words cloud mcp
prompt: create a new empty document called minutes.docx in the meetings folder of my MyStorage storage using aspose words cloud mcp
prompt: do a dry run of creating a new document called agenda.docx using aspose words cloud mcp

각 서버에는 네 가지 공유 파일 도구(업로드, 다운로드, 목록, 삭제)도 포함되어 있어 하나의 서버만으로 전체 업로드·처리·다운로드 워크플로우를 수행할 수 있습니다.