Aspose Cloud API
Aspose.PDF Cloud MCP Server
Cloud APIPDF
Release v1.1.4
Merge PDF documents, convert PDF to Word and read document properties through Aspose.PDF Cloud's REST API, from any MCP-compatible AI client.
설정
Aspose.PDF 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-pdf-cloud-python-mcp.git@v1.1.4
이렇게 하면 aspose-pdf-mcp 명령이 가상 환경에 추가됩니다.
Aspose.PDF Cloud을(를) AI 클라이언트에 구성
Aspose Cloud 대시보드에서 애플리케이션을 생성해 Client ID와 Client Secret을 얻으세요(무료 평가 티어 제공). 서버는 시작 시 환경에서 이를 읽으며, 도구 인자로는 절대 전달되지 않습니다. ASPOSE_FILES_PATH는 서버가 파일을 읽고 결과를 쓸 수 있는 컴퓨터의 폴더입니다.
{
"mcpServers": {
"pdf": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-pdf-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-pdf-mcp"{
"servers": {
"pdf": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-pdf-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
시도해 보기
예시 프롬프트
- Upload report.pdf, tell me its title and author, then convert it to Word and download it.
- Merge 4pages.pdf and 5pages.pdf and tell me how many pages the result has.
레퍼런스
사용 가능한 도구 (3)
이 서버가 제공하는 모든 도구는 자체 도구 매니페스트에서 직접 가져옵니다.
| 도구 | 설명 | 매개변수 |
|---|---|---|
pdf_convert_to_doc |
Converts a PDF file stored in Aspose Cloud storage to a Word document (DOC or DOCX) and returns the converted file content. 읽기 전용 |
filename: str (필수), folder_name: str | None, storage_name: str | None, output_filename: str | None, return_base64: bool
|
| prompt: convert invoice.pdf to a Word document using aspose pdf cloud mcp | ||
| prompt: convert scan.pdf to docx and save as scan-editable.docx using aspose pdf cloud mcp | ||
| prompt: convert invoice.pdf from the invoices folder of my MyStorage storage to Word and return it as base64 text using aspose pdf cloud mcp | ||
pdf_merge_documents |
This tool merges a list of PDF documents into a single PDF file with a specified result name. 드라이 런 |
filename: str (필수), merge_request: dict[str, Any] (필수), storage_name: str | None, folder_name: str | None, dry_run: bool
|
| prompt: merge part1.pdf, part2.pdf and part3.pdf into full-report.pdf using aspose pdf cloud mcp | ||
| prompt: merge jan.pdf and feb.pdf from the reports folder of my MyStorage storage into q1.pdf using aspose pdf cloud mcp | ||
| prompt: do a dry run of merging cover.pdf and body.pdf into book.pdf using aspose pdf cloud mcp | ||
pdf_get_document_properties |
Retrieves the metadata properties of a specified PDF document from Aspose Cloud storage. 읽기 전용 |
filename: str (필수), folder_name: str | None, storage_name: str | None
|
| prompt: show the author, title and creation date of brochure.pdf using aspose pdf cloud mcp | ||
| prompt: show the properties of brochure.pdf from the marketing folder of my MyStorage storage using aspose pdf cloud mcp | ||
각 서버에는 네 가지 공유 파일 도구(업로드, 다운로드, 목록, 삭제)도 포함되어 있어 하나의 서버만으로 전체 업로드·처리·다운로드 워크플로우를 수행할 수 있습니다.
더 살펴보기