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 أو أحدث. قم بتثبيت الخادم داخل بيئة افتراضية؛ الحزمة الأولى هي مكتبة الأدوات المشتركة التي تعتمد عليها جميع خوادم 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 باستخدام 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 (مطلوب), 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 باستخدام 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 (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: عرض المؤلف، العنوان وتاريخ الإنشاء لملف brochure.pdf باستخدام aspose pdf cloud mcp | ||
| موجه: عرض خصائص brochure.pdf من مجلد marketing في تخزين MyStorage باستخدام aspose pdf cloud mcp | ||
كل خادم يتضمن أيضًا أربعة أدوات ملفات مشتركة (رفع، تنزيل، سرد وحذف)، لذا خادم واحد يكفي لخط عمل كامل للرفع، المعالجة، والتنزيل.