Aspose.PDF Cloud Servidor 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.
Instalar Aspose.PDF Cloud
Necesitas Python 3.11 o superior. Instala el servidor en un entorno virtual; el primer paquete es la biblioteca compartida de herramientas de archivo de la que depende cada servidor MCP de Aspose Cloud.
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
Esto coloca el comando aspose-pdf-mcp dentro del entorno virtual.
Configura Aspose.PDF Cloud en tu cliente IA
Crea una aplicación en tu panel de Aspose Cloud para obtener un Client ID y un Client Secret (hay un nivel de evaluación gratuito disponible). El servidor los lee de su entorno al iniciarse; nunca se pasan como argumento de herramienta. ASPOSE_FILES_PATH es la carpeta en tu ordenador desde la que el servidor puede leer archivos y a la que puede escribir resultados.
{
"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"
}
}
}
}// La misma estructura JSON que VS Code arriba — usa la ruta de configuración para tu herramienta: // ~/.cursor/mcp.json · Configuración de Cline · Windsurf mcp_config.json
Ejemplos de prompts
- 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.
Herramientas disponibles (3)
Cada herramienta que expone este servidor, directamente desde su propio manifiesto de herramientas.
| Herramienta | Descripción | Parámetros |
|---|---|---|
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. Solo lectura |
filename: str (requerido), folder_name: str | None, storage_name: str | None, output_filename: str | None, return_base64: bool
|
| prompt: convierte invoice.pdf a un documento Word usando aspose pdf cloud mcp | ||
| prompt: convierte scan.pdf a docx y guárdalo como scan-editable.docx usando aspose pdf cloud mcp | ||
| prompt: convierte invoice.pdf de la carpeta invoices de mi MyStorage storage a Word y devuélvelo como texto base64 usando 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. Ejecución de prueba |
filename: str (requerido), merge_request: dict[str, Any] (requerido), storage_name: str | None, folder_name: str | None, dry_run: bool
|
| prompt: fusiona part1.pdf, part2.pdf y part3.pdf en full-report.pdf usando aspose pdf cloud mcp | ||
| prompt: fusiona jan.pdf y feb.pdf de la carpeta reports de mi MyStorage storage en q1.pdf usando aspose pdf cloud mcp | ||
| prompt: realiza una ejecución de prueba de fusionar cover.pdf y body.pdf en book.pdf usando aspose pdf cloud mcp | ||
pdf_get_document_properties |
Retrieves the metadata properties of a specified PDF document from Aspose Cloud storage. Solo lectura |
filename: str (requerido), folder_name: str | None, storage_name: str | None
|
| prompt: muestra el autor, título y fecha de creación de brochure.pdf usando aspose pdf cloud mcp | ||
| prompt: muestra las propiedades de brochure.pdf de la carpeta marketing de mi MyStorage storage usando aspose pdf cloud mcp | ||
Cada servidor también incluye cuatro herramientas de archivo compartidas (subir, descargar, listar y eliminar), por lo que un solo servidor basta para un flujo completo de subir, procesar y descargar.