Aspose.Words Cloud MCP Server
Convert, create and compare Word documents, replace text, and read bookmarks, comments, properties and statistics, through Aspose.Words Cloud's REST API, from any MCP-compatible AI client.
تثبيت Aspose.Words 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-words-cloud-python-mcp.git@v2.0.1
هذا يضع أمر aspose-words-mcp داخل البيئة الافتراضية.
ضبط Aspose.Words Cloud في عميل AI الخاص بك
أنشئ تطبيقًا في لوحة تحكم Aspose Cloud للحصول على معرّف العميل (Client ID) والسر الخاص بالعميل (Client Secret) (يتوفر مستوى تجريبي مجاني). يقرأ الخادم هذه القيم من بيئته عند بدء التشغيل؛ لا يتم تمريرها أبدًا كوسيطة للأداة. ASPOSE_FILES_PATH هو المجلد على جهازك الذي يمكن للخادم قراءة الملفات منه وكتابة النتائج إليه.
{
"mcpServers": {
"words": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-words-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-words-mcp"{
"servers": {
"words": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-words-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.docx, convert it to PDF and download the result.
- How many pages and words does contract.docx have?
- In proposal.docx replace every "Acme Ltd" with "Acme Inc" and save the result as proposal-v2.docx.
- List the comments and bookmarks in review-draft.docx.
الأدوات المتاحة (11)
كل أداة يعرّفها هذا الخادم، مباشرة من ملف التعريف الخاص به.
| الأداة | الوصف | المعلمات |
|---|---|---|
words_get_document_bookmarks |
Retrieves the list of bookmarks and their common information from a specified Word document stored in Aspose Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: قائمة العلامات المرجعية في contract.docx باستخدام aspose words cloud mcp | ||
| موجه: قائمة العلامات المرجعية في contract.docx من مجلد legal في تخزين MyStorage باستخدام aspose words cloud mcp | ||
words_get_comments |
Retrieves all comments from a specified Word document stored in Aspose Cloud. للقراءة فقط |
name: str (مطلوب), folder: str | None, storage: str | None, load_encoding: str | None
|
| موجه: عرض جميع التعليقات في review-draft.docx باستخدام aspose words cloud mcp | ||
| موجه: عرض جميع التعليقات في review-draft.docx من مجلد reviews، قراءتها كـ utf-8، باستخدام aspose words cloud mcp | ||
| موجه: عرض جميع التعليقات في review-draft.docx من تخزين MyStorage باستخدام aspose words cloud mcp | ||
words_compare_document |
Compares a source Word document with another document and produces a new file that highlights the differences. تشغيل تجريبي |
filename: str (مطلوب), compare_request: dict[str, Any] (مطلوب), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, dry_run: bool
|
| موجه: مقارنة contract-v1.docx بـ contract-v2.docx وحفظ الاختلافات المميَّزة كـ contract-diff.docx باستخدام aspose words cloud mcp | ||
| موجه: معاينة مقارنة draft.docx مع final.docx، دون حفظ أي شيء، باستخدام dry run، باستخدام aspose words cloud mcp | ||
words_download_document |
Exports a document stored in Aspose Cloud to the specified output format, optionally saving the result to a given path. للقراءة فقط |
filename: str (مطلوب), target_format: str (مطلوب), folder_name: str | None, storage_name: str | None, output_path: str | None, output_filename: str | None, return_base64: bool
|
| موجه: تحميل report.docx من التخزين السحابي كـ pdf باستخدام aspose words cloud mcp | ||
| موجه: تصدير notes.docx كـ html وحفظه كـ notes.html في مجلد exports باستخدام aspose words cloud mcp | ||
| موجه: تصدير summary.docx من مجلد reports كـ pdf وإرجاعه كنص base64 بدلاً من حفظه، باستخدام aspose words cloud mcp | ||
words_convert_to_format |
Converts a supplied document to a specified format and returns the converted file (or saves it to a given storage path). للقراءة فقط |
document_filename: str (مطلوب), target_format: str (مطلوب), storage_name: str | None, output_path: str | None, source_filename_hint: str | None, content_base64: str | None, output_filename: str | None, return_base64: bool
|
| موجه: تحويل report.docx إلى pdf باستخدام aspose words cloud mcp | ||
| موجه: تحويل letter.rtf إلى docx وحفظه كـ letter.docx في مجلد converted باستخدام aspose words cloud mcp | ||
| موجه: تحويل هذا المحتوى base64، وهو ملف docx باسم report.docx، إلى pdf وإرجاع النتيجة كـ base64 باستخدام aspose words cloud mcp | ||
words_save_document_as |
Save a Cloud-stored Word document in another format via explicit save options تشغيل تجريبي |
filename: str (مطلوب), save_options: dict[str, Any] (مطلوب), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, fonts_location: str | None, dry_run: bool
|
| موجه: حفظ proposal.docx كـ pdf باسم proposal-final.pdf باستخدام aspose words cloud mcp | ||
| موجه: إجراء dry run لحفظ brochure.docx كـ pdf باستخدام الخطوط الموجودة في مجلد my-fonts، باستخدام aspose words cloud mcp | ||
| موجه: حفظ legacy.docx من مجلد archive كـ pdf، قراءته كـ utf-8، باستخدام aspose words cloud mcp | ||
words_get_document_properties |
Retrieves the full set of document properties from a Word file stored in Aspose Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None
|
| موجه: عرض خصائص المستند report.docx باستخدام aspose words cloud mcp | ||
| موجه: عرض خصائص المستند report.docx من مجلد reports في تخزين MyStorage باستخدام aspose words cloud mcp | ||
words_get_available_fonts |
Retrieves the list of fonts that are available for processing Aspose.Words documents. للقراءة فقط |
fonts_location: str | None
|
| موجه: قائمة الخطوط المتاحة لمعالجة المستندات باستخدام aspose words cloud mcp | ||
| موجه: قائمة الخطوط المتاحة في مجلد my-fonts باستخدام aspose words cloud mcp | ||
words_get_document_statistics |
Retrieves statistical information (e.g., word, character, paragraph, and page counts) for a specified Word document stored in Aspose Cloud. للقراءة فقط |
filename: str (مطلوب), folder_name: str | None, storage_name: str | None, include_comments: bool | None, include_footnotes: bool | None, include_text_in_shapes: bool | None
|
| موجه: كم عدد الصفحات، الكلمات والفقرات في thesis.docx؟ استخدم aspose words cloud mcp | ||
| موجه: احسب عدد الكلمات في thesis.docx بما في ذلك التعليقات、الهوامش والنص داخل الأشكال، باستخدام aspose words cloud mcp | ||
words_replace_text |
Replaces all occurrences of a specified text pattern in a Word document stored in Aspose Cloud and optionally saves the modified document under a new name. تشغيل تجريبي |
filename: str (مطلوب), replace_request: dict[str, Any] (مطلوب), folder_name: str | None, storage_name: str | None, load_encoding: str | None, destination_filename: str | None, revision_author: str | None, revision_date_time: str | None, dry_run: bool
|
| موجه: استبدال 'Acme Ltd' بـ 'Acme Inc' في proposal.docx وحفظه كـ proposal-v2.docx باستخدام aspose words cloud mcp | ||
| موجه: استبدال 'draft' بـ 'final' في handbook.docx كتعديل متتبع بواسطة المؤلف 'Jane Doe' بتاريخ 2026-10-23T09:00:00Z باستخدام aspose words cloud mcp | ||
| موجه: إجراء dry run لاستبدال 2025 بـ 2026 في handbook.docx من مجلد hr، قراءته كـ utf-8، باستخدام aspose words cloud mcp | ||
words_create_document |
Creates a new Word document in Aspose Cloud storage with a filename and format inferred from its extension. تشغيل تجريبي |
storage_name: str | None, filename: str | None, folder_name: str | None, dry_run: bool
|
| موجه: إنشاء مستند جديد فارغ باسم meeting-notes.docx باستخدام aspose words cloud mcp | ||
| موجه: إنشاء مستند جديد فارغ باسم minutes.docx في مجلد meetings في تخزين MyStorage باستخدام aspose words cloud mcp | ||
| موجه: إجراء dry run لإنشاء مستند جديد باسم agenda.docx باستخدام aspose words cloud mcp | ||
كل خادم يتضمن أيضًا أربعة أدوات ملفات مشتركة (رفع، تنزيل، سرد وحذف)، لذا خادم واحد يكفي لخط عمل كامل للرفع، المعالجة، والتنزيل.