Aspose.Words Cloud سرور MCP
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 یا بالاتر نیاز دارید. سرور را در یک محیط مجازی نصب کنید؛ اولین بسته کتابخانه فایل-ابزار مشترک است که هر سرور MCP Aspose Cloud به آن وابسته است.
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"
}
}
}
}// Same JSON shape as VS Code above — use the config path for your tool: // ~/.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 را که فایلی به نام 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 ایجاد کنید | ||
هر سرور همچنین شامل چهار ابزار فایل مشترک (بارگذاری، بارگیری، لیست و حذف) است، بنابراین یک سرور کافی است برای یک ورکفلو کامل بارگذاری‑پردازش‑بارگیری.