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.
Установить 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 (required), folder_name: str | None, storage_name: str | None, output_filename: str | None, return_base64: bool
|
| запрос: конвертировать invoice.pdf в документ Word с помощью aspose pdf cloud mcp | ||
| запрос: конвертировать scan.pdf в docx и сохранить как scan-editable.docx с помощью aspose pdf cloud mcp | ||
| запрос: конвертировать invoice.pdf из папки invoices моего хранилища MyStorage в Word и вернуть как base64‑текст с помощью 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 (required), merge_request: dict[str, Any] (required), storage_name: str | None, folder_name: str | None, dry_run: bool
|
| запрос: объединить part1.pdf, part2.pdf и part3.pdf в full-report.pdf с помощью aspose pdf cloud mcp | ||
| запрос: объединить jan.pdf и feb.pdf из папки reports моего хранилища MyStorage в q1.pdf с помощью aspose pdf cloud mcp | ||
| запрос: выполнить dry run объединения cover.pdf и body.pdf в book.pdf с помощью aspose pdf cloud mcp | ||
pdf_get_document_properties |
Retrieves the metadata properties of a specified PDF document from Aspose Cloud storage. Только чтение |
filename: str (required), folder_name: str | None, storage_name: str | None
|
| запрос: показать автора, название и дату создания файла brochure.pdf с помощью aspose pdf cloud mcp | ||
| запрос: показать свойства файла brochure.pdf из папки marketing моего хранилища MyStorage с помощью aspose pdf cloud mcp | ||
Каждый сервер также включает четыре общих файловых инструмента (upload, download, list и delete), поэтому один сервер достаточен для полного рабочего процесса загрузки, обработки и скачивания.