Aspose.PDF Cloud MCP Server
Merge PDF documents, convert PDF to Word and read document properties through Aspose.PDF Cloud's REST API, from any MCP-compatible AI client.
Cài đặt Aspose.PDF Cloud
Bạn cần Python 3.11 hoặc mới hơn. Cài đặt server vào môi trường ảo; gói đầu tiên là thư viện công cụ tệp chia sẻ mà mọi Aspose Cloud MCP server đều phụ thuộc.
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
Lệnh aspose-pdf-mcp sẽ được đặt vào môi trường ảo.
Cấu hình Aspose.PDF Cloud trong AI client của bạn
Tạo một ứng dụng trên bảng điều khiển Aspose Cloud của bạn để lấy Client ID và Client Secret (có giai đoạn đánh giá miễn phí). Server đọc chúng từ môi trường khi khởi động; chúng không bao giờ được truyền dưới dạng tham số công cụ. ASPOSE_FILES_PATH là thư mục trên máy của bạn mà server có thể đọc tệp và ghi kết quả vào.
{
"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
Ví dụ prompt
- 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.
Công cụ khả dụng (3)
Mỗi công cụ mà máy chủ này cung cấp, lấy trực tiếp từ manifest công cụ của nó.
| Công cụ | Mô tả | Tham số |
|---|---|---|
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. Chỉ đọc |
filename: str (bắt buộc), 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. Chạy thử |
filename: str (bắt buộc), merge_request: dict[str, Any] (bắt buộc), 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. Chỉ đọc |
filename: str (bắt buộc), 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 | ||
Mỗi server cũng bao gồm bốn công cụ tệp chia sẻ (upload, download, list và delete), vì vậy một server duy nhất đã đủ cho quy trình tải lên, xử lý, tải xuống hoàn chỉnh.