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.
Instalar Aspose.PDF Cloud
Você precisa do Python 3.11 ou superior. Instale o servidor em um ambiente virtual; o primeiro pacote é a biblioteca compartilhada de ferramentas de arquivos da qual todo servidor MCP Aspose Cloud depende.
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
Isso coloca o comando aspose-pdf-mcp no ambiente virtual.
Configure Aspose.PDF Cloud no seu cliente AI
Crie uma aplicação no seu painel Aspose Cloud para obter um Client ID e um Client Secret (há um nível de avaliação gratuito disponível). O servidor os lê do seu ambiente ao iniciar; eles nunca são passados como argumento de ferramenta. ASPOSE_FILES_PATH é a pasta no seu computador da qual o servidor pode ler arquivos e para a qual pode gravar 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"
}
}
}
}// Mesmo formato JSON que o VS Code acima — use o caminho de config para sua ferramenta: // ~/.cursor/mcp.json · Cline settings · Windsurf mcp_config.json
Prompts de exemplo
- 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.
Ferramentas disponíveis (3)
Cada ferramenta que este servidor expõe, diretamente de seu próprio manifesto de ferramentas.
| Ferramenta | Descrição | 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. Somente leitura |
filename: str (obrigatório), folder_name: str | None, storage_name: str | None, output_filename: str | None, return_base64: bool
|
| prompt: converter invoice.pdf para um documento Word usando aspose pdf cloud mcp | ||
| prompt: converter scan.pdf para docx e salvar como scan-editable.docx usando aspose pdf cloud mcp | ||
| prompt: converter invoice.pdf da pasta invoices do meu armazenamento MyStorage para Word e retorná‑lo 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. Execução simulada |
filename: str (obrigatório), merge_request: dict[str, Any] (obrigatório), storage_name: str | None, folder_name: str | None, dry_run: bool
|
| prompt: mesclar part1.pdf, part2.pdf e part3.pdf em full-report.pdf usando aspose pdf cloud mcp | ||
| prompt: mesclar jan.pdf e feb.pdf da pasta reports do meu armazenamento MyStorage em q1.pdf usando aspose pdf cloud mcp | ||
| prompt: executar uma simulação de mesclar cover.pdf e body.pdf em book.pdf usando aspose pdf cloud mcp | ||
pdf_get_document_properties |
Retrieves the metadata properties of a specified PDF document from Aspose Cloud storage. Somente leitura |
filename: str (obrigatório), folder_name: str | None, storage_name: str | None
|
| prompt: exibir o autor, título e data de criação de brochure.pdf usando aspose pdf cloud mcp | ||
| prompt: exibir as propriedades de brochure.pdf da pasta marketing do meu armazenamento MyStorage usando aspose pdf cloud mcp | ||
Cada servidor também inclui quatro ferramentas de arquivos compartilhadas (upload, download, list e delete), portanto um único servidor basta para um fluxo completo de upload, processamento e download.