Aspose Cloud API
Aspose.PDF Cloud MCP Server
Cloud APIPDF
发行版 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 命令放入虚拟环境中。
在您的 AI 客户端中配置 Aspose.PDF Cloud
在 Aspose Cloud 仪表板上创建应用以获取客户端 ID 和客户端密钥（提供免费试用层）。服务器启动时会从其环境读取这些信息；它们永不作为工具参数传递。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"
}
}
}
}// 与上面的 VS Code 相同的 JSON 结构 —— 使用工具的配置路径： // ~/.cursor/mcp.json · Cline 设置 · 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
|
| 提示：convert invoice.pdf to a Word document using aspose pdf cloud mcp | ||
| 提示：convert scan.pdf to docx and save as scan-editable.docx using aspose pdf cloud mcp | ||
| 提示：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
|
| 提示：merge part1.pdf, part2.pdf and part3.pdf into full-report.pdf using aspose pdf cloud mcp | ||
| 提示：merge jan.pdf and feb.pdf from the reports folder of my MyStorage storage into q1.pdf using aspose pdf cloud mcp | ||
| 提示：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
|
| 提示：show the author, title and creation date of brochure.pdf using aspose pdf cloud mcp | ||
| 提示：show the properties of brochure.pdf from the marketing folder of my MyStorage storage using aspose pdf cloud mcp | ||
每个服务器还内置四个共享文件工具（上传、下载、列出和删除），因此单个服务器即可完成完整的上传、处理、下载工作流。
探索更多