Aspose.Slides Cloud MCP Server
Create, convert and split presentations, read slides, text and images, and replace text, through Aspose.Slides Cloud's REST API, from any MCP-compatible AI client.
تثبيت Aspose.Slides 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-slides-cloud-python-mcp.git@v1.0.3
هذا يضع أمر aspose-slides-mcp داخل البيئة الافتراضية.
ضبط Aspose.Slides Cloud في عميل AI الخاص بك
أنشئ تطبيقًا في لوحة تحكم Aspose Cloud للحصول على معرّف العميل (Client ID) والسر الخاص بالعميل (Client Secret) (يتوفر مستوى تجريبي مجاني). يقرأ الخادم هذه القيم من بيئته عند بدء التشغيل؛ لا يتم تمريرها أبدًا كوسيطة للأداة. ASPOSE_FILES_PATH هو المجلد على جهازك الذي يمكن للخادم قراءة الملفات منه وكتابة النتائج إليه.
{
"mcpServers": {
"slides": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-slides-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-slides-mcp"{
"servers": {
"slides": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-slides-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
أمثلة على التعليمات
- List the slides in deck.pptx and extract all of their text.
- In deck.pptx replace "Q3" with "Q4" everywhere.
- Split deck.pptx into one image per slide.
الأدوات المتاحة (8)
كل أداة يعرّفها هذا الخادم، مباشرة من ملف التعريف الخاص به.
| الأداة | الوصف | المعلمات |
|---|---|---|
slides_create_presentation |
Creates a new presentation in Aspose Slides, optionally using an uploaded source file as a template and optionally applying a password to the new file. تشغيل تجريبي |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None, dry_run: bool
|
| موجه: إنشاء عرض تقديمي جديد باسم quarterly-review.pptx باستخدام aspose slides cloud mcp | ||
| موجه: إنشاء عرض تقديمي جديد باسم kickoff.pptx في مجلد decks في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
| موجه: إجراء dry run لإنشاء عرض تقديمي باسم demo.pptx باستخدام aspose slides cloud mcp | ||
slides_download_presentation |
The tool retrieves a presentation from Aspose Slides Cloud, converts it to a specified export format, and returns the resulting file as binary data. للقراءة فقط |
filename: str (مطلوب), target_format: str (مطلوب), folder_name: str | None, storage_name: str | None, fonts_folder_name: str | None, slide_indices: str | None, output_filename: str | None, return_base64: bool
|
| موجه: تحميل deck.pptx كـ pdf باستخدام aspose slides cloud mcp | ||
| موجه: تصدير الشرائح 1 و 3 فقط من deck.pptx كـ pdf وحفظه كـ deck-excerpt.pdf باستخدام aspose slides cloud mcp | ||
| موجه: تصدير deck.pptx من مجلد decks كـ pdf باستخدام الخطوط الموجودة في مجلد my-fonts، وإرجاعه كنص base64، باستخدام aspose slides cloud mcp | ||
slides_split_presentation |
This tool splits a PowerPoint presentation into separate image files, creating one image for each selected slide and uploading the images to cloud storage. تشغيل تجريبي |
filename: str (مطلوب), target_format: str | None, width: str | None, height: str | None, from_slide: str | None, to_slide: str | None, destination_folder_name: str | None, storage_name: str | None, folder_name: str | None, fonts_folder_name: str | None, dry_run: bool
|
| موجه: تقسيم deck.pptx إلى صورة png لكل شريحة باستخدام aspose slides cloud mcp | ||
| موجه: تصدير الشرائح 2 إلى 5 من deck.pptx كصور jpeg بدقة 1280 × 720 في مجلد slide-images باستخدام aspose slides cloud mcp | ||
| موجه: إجراء dry run لتقسيم deck.pptx من مجلد decks في تخزين MyStorage إلى صور باستخدام الخطوط الموجودة في مجلد my-fonts، باستخدام aspose slides cloud mcp | ||
slides_list_images |
Retrieves metadata for every image that is embedded in a specified PowerPoint presentation stored in Aspose Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: قائمة الصور المضمنة في brand-guidelines.pptx باستخدام aspose slides cloud mcp | ||
| موجه: قائمة الصور المضمنة في brand-guidelines.pptx من مجلد brand في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
slides_get_presentation_properties |
Retrieves the metadata properties of a PowerPoint presentation file stored in Aspose Slides Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: عرض خصائص deck.pptx باستخدام aspose slides cloud mcp | ||
| موجه: عرض خصائص deck.pptx من مجلد decks في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
slides_list_slides |
Retrieves information about all slides in a specified PowerPoint presentation stored in Aspose Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: قائمة جميع الشرائح في roadmap.pptx باستخدام aspose slides cloud mcp | ||
| موجه: قائمة جميع الشرائح في roadmap.pptx من مجلد planning في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
slides_get_text_items |
Extracts all text items from a specified PowerPoint presentation file. للقراءة فقط |
filename: str (مطلوب), with_empty: bool | None, folder_name: str | None, storage_name: str | None
|
| موجه: استخراج كل النص من pitch.pptx باستخدام aspose slides cloud mcp | ||
| موجه: استخراج كل النص من pitch.pptx، بما في ذلك عناصر النص الفارغة، باستخدام aspose slides cloud mcp | ||
| موجه: استخراج كل النص من pitch.pptx في مجلد sales في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
slides_replace_text |
Replaces every occurrence of a specified text string in a Slides presentation with a new string. تشغيل تجريبي |
filename: str (مطلوب), old_value: str (مطلوب), new_value: str (مطلوب), ignore_case: bool | None, whole_words_only: bool | None, folder_name: str | None, storage_name: str | None, dry_run: bool
|
| موجه: استبدال 'Q3' بـ 'Q4' في deck.pptx باستخدام aspose slides cloud mcp | ||
| موجه: استبدال الكلمة الكاملة 'cost' بـ 'spend' في deck.pptx، مع تجاهل الحالة، باستخدام aspose slides cloud mcp | ||
| موجه: إجراء dry run لاستبدال 'Acme' بـ 'Globex' في pitch.pptx من مجلد sales في تخزين MyStorage باستخدام aspose slides cloud mcp | ||
كل خادم يتضمن أيضًا أربعة أدوات ملفات مشتركة (رفع، تنزيل، سرد وحذف)، لذا خادم واحد يكفي لخط عمل كامل للرفع، المعالجة، والتنزيل.