واجهة برمجة تطبيقات Aspose Cloud

Aspose.Words Cloud MCP Server

واجهة برمجة تطبيقات سحابية APIمعالجة النصوص DOCXDOCRTFODT الإصدار v2.0.1

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"
جرّبه

أمثلة على التعليمات

  • 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

كل خادم يتضمن أيضًا أربعة أدوات ملفات مشتركة (رفع، تنزيل، سرد وحذف)، لذا خادم واحد يكفي لخط عمل كامل للرفع، المعالجة، والتنزيل.

استكشاف المزيد

خوادم MCP الأخرى لـ Aspose Cloud