Aspose.PDF Cloud MCP сервер
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 або новіший. Встановіть сервер у віртуальне середовище; перший пакет — це спільна бібліотека file-tool, від якої залежать усі сервери 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"
}
}
}
}// Така ж форма JSON, як у VS Code вище — використайте шлях конфігурації для вашого інструменту: // ~/.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
|
| запит: конвертувати invoice.pdf у Word‑документ using aspose pdf cloud mcp | ||
| запит: конвертувати scan.pdf у docx і зберегти як scan-editable.docx using aspose pdf cloud mcp | ||
| запит: конвертувати invoice.pdf з папки invoices мого MyStorage storage у Word і повернути як base64‑текст 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
|
| запит: об’єднати part1.pdf, part2.pdf та part3.pdf у full-report.pdf using aspose pdf cloud mcp | ||
| запит: об’єднати jan.pdf та feb.pdf з папки reports мого MyStorage storage у q1.pdf using aspose pdf cloud mcp | ||
| запит: виконати dry run об’єднання cover.pdf та body.pdf у 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
|
| запит: показати автора, назву та дату створення brochure.pdf using aspose pdf cloud mcp | ||
| запит: показати властивості brochure.pdf з папки marketing мого MyStorage storage using aspose pdf cloud mcp | ||
Кожен сервер також містить чотири спільних файлових інструменти (upload, download, list та delete), тому одного сервера достатньо для повного процесу завантаження, обробки та скачування.