Aspose Cloud API
Aspose.Email Cloud MCP Server
Cloud APIEmail processing
MSGEMLICSVCFPSTMHTML
发行版 v1.4.0
Convert and read e-mail messages, contacts and calendars, and work with a mailbox (folders, messages and threads), through Aspose.Email Cloud's REST API, from any MCP-compatible AI client.
设置
安装 Aspose.Email 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-email-cloud-python-mcp.git@v1.4.0
这会将 aspose-email-mcp 命令放入虚拟环境中。
在您的 AI 客户端中配置 Aspose.Email Cloud
在 Aspose Cloud 仪表板上创建应用以获取客户端 ID 和客户端密钥（提供免费试用层）。服务器启动时会从其环境读取这些信息；它们永不作为工具参数传递。ASPOSE_FILES_PATH 是服务器可以读取文件并写入结果的本地文件夹。
{
"mcpServers": {
"email": {
"command": "C:\\path\\to\\.venv\\Scripts\\aspose-email-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-email-mcp"{
"servers": {
"email": {
"type": "stdio",
"command": "/path/to/.venv/bin/aspose-email-mcp",
"env": {
"ASPOSE_CLIENT_ID": "your-client-id",
"ASPOSE_CLIENT_SECRET": "your-client-secret",
"ASPOSE_FILES_PATH": "/home/you/aspose-files"
}
}
}
}// 与上面的 VS Code 相同的 JSON 结构 —— 使用工具的配置路径： // ~/.cursor/mcp.json · Cline 设置 · Windsurf mcp_config.json
试用
示例提示
- Convert message.msg to EML.
- List the e-mail files in the inbox folder of my storage.
- Is someone@mailinator.com a disposable e-mail address?
参考
可用工具 (53)
此服务器公开的每个工具，都直接源自其工具清单。
| 工具 | 描述 | 参数 |
|---|---|---|
email_get_calendar |
Retrieves the specified iCalendar file from cloud storage. 只读 |
file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the events in team-meeting.ics using aspose email cloud mcp | ||
| 提示：show the events in team-meeting.ics from the calendars folder of my MyStorage storage using aspose email cloud mcp | ||
email_get_calendar_list |
Retrieves a paginated list of iCalendar files stored in a specified folder. 只读 |
folder: str（必需）, items_per_page: str | None, page_number: str | None, storage: str | None
|
| 提示：list the calendar files in the calendars folder using aspose email cloud mcp | ||
| 提示：list the calendar files in the calendars folder, 20 per page, page 2, using aspose email cloud mcp | ||
email_get_calendar_as_alternate |
Retrieves an iCalendar file from Aspose Cloud storage and returns its AlternateView representation based on the specified calendar action. 只读 |
file_name: str（必需）, calendar_action: str（必需）, sequence_id: str | None, folder: str | None, storage: str | None
|
| 提示：get the alternate view of invite.ics for a 'create' calendar action using aspose email cloud mcp | ||
| 提示：get the alternate view of invite.ics for a 'cancel' calendar action with sequence id 2 using aspose email cloud mcp | ||
email_get_calendar_as_file |
This tool fetches a calendar document from Aspose Cloud storage, converts it to the specified format, and returns the resulting file. 只读 |
file_name: str（必需）, format: str（必需）, storage: str | None, folder: str | None
|
| 提示：convert team-meeting.ics to msg format using aspose email cloud mcp | ||
| 提示：convert team-meeting.ics from the calendars folder of my MyStorage storage to msg format using aspose email cloud mcp | ||
email_run_calendar_from_file |
The tool converts an uploaded calendar file into a structured calendar model representation. 演练模式 |
file: str（必需）, content_base64: str | None, dry_run: bool
|
| 提示：parse the calendar file offsite.ics into a structured calendar using aspose email cloud mcp | ||
| 提示：do a dry run of parsing this base64 content as the calendar file offsite.ics using aspose email cloud mcp | ||
email_get_contact |
The tool retrieves a contact document from the specified storage location. 只读 |
format: str（必需）, file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the contact details in john-smith.vcf, which is in vcard format, using aspose email cloud mcp | ||
email_get_contact_list |
Retrieves a list of email contacts from a specified folder and storage using the given contact document format. 只读 |
format: str（必需）, folder: str | None, storage: str | None, items_per_page: str | None, page_number: str | None
|
| 提示：list the vcard contacts using aspose email cloud mcp | ||
| 提示：list the vcard contacts in the contacts folder of my MyStorage storage, 50 per page, page 3, using aspose email cloud mcp | ||
email_get_contact_as_file |
Converts a contact document stored in Aspose Cloud from one format to another and returns the resulting file as binary data. 只读 |
file_name: str（必需）, to_format: str（必需）, from_format: str（必需）, storage: str | None, folder: str | None
|
| 提示：convert john-smith.vcf from vcard to msg format using aspose email cloud mcp | ||
| 提示：convert john-smith.msg from msg to vcard format, from the contacts folder of my MyStorage storage, using aspose email cloud mcp | ||
email_run_contact_from_file |
Converts a contact document file (VCard, WebDav, or Msg) into its Aspose.Email model representation. 演练模式 |
format: str（必需）, file: str（必需）, content_base64: str | None, dry_run: bool
|
| 提示：parse the vcard file partners.vcf into structured contacts using aspose email cloud mcp | ||
| 提示：do a dry run of parsing this base64 content as the vcard file partners.vcf using aspose email cloud mcp | ||
email_get_list |
The tool retrieves a list of email files stored in a specified folder of Aspose Cloud storage. 只读 |
format: str（必需）, folder: str | None, storage: str | None, items_per_page: str | None, page_number: str | None
|
| 提示：list the eml emails using aspose email cloud mcp | ||
| 提示：list the eml emails in the inbox-export folder, 25 per page, page 2, using aspose email cloud mcp | ||
email_get_as_file |
The tool fetches an email document from Aspose Cloud storage, converts it to a specified format, and returns the result as a downloadable file. 只读 |
file_name: str（必需）, format: str（必需）, storage: str | None, folder: str | None
|
| 提示：convert message.eml to msg format using aspose email cloud mcp | ||
| 提示：convert message.eml from the inbox-export folder of my MyStorage storage to msg format using aspose email cloud mcp | ||
email_extract_properties |
This tool converts an email document file into a structured email model representation. 演练模式 |
content_filename: str（必需）, source_format: str（必需）, content_base64: str | None, dry_run: bool
|
| 提示：extract the sender, recipients and subject from message.eml, which is in eml format, using aspose email cloud mcp | ||
| 提示：extract the sender, recipients and subject from this base64 content, which is an eml file named message.eml, using aspose email cloud mcp | ||
email_convert_file |
It converts an uploaded email document from a given source format to a specified target format and returns the resulting file. 只读 |
content_filename: str（必需）, source_format: str（必需）, target_format: str（必需）, content_base64: str | None, output_filename: str | None, return_base64: bool
|
| 提示：convert message.eml from eml to msg and save as message.msg using aspose email cloud mcp | ||
| 提示：convert newsletter.msg from msg to eml and return it as base64 text using aspose email cloud mcp | ||
| 提示：convert this base64 content, an eml file named invoice.eml, to msg using aspose email cloud mcp | ||
email_get_mapi_calendar |
This tool retrieves a MAPI calendar file from Aspose Cloud storage. 只读 |
file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the MAPI calendar appointment in meeting.msg using aspose email cloud mcp | ||
email_get_mapi_contact |
Retrieves a MAPI contact document from Aspose Cloud storage in the format you specify. 只读 |
format: str（必需）, file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the MAPI contact in colleague.msg, in msg format, using aspose email cloud mcp | ||
email_get_mapi_message |
This tool retrieves a specific email document stored as a MAPI message from Aspose Cloud. 只读 |
format: str（必需）, file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the MAPI message in support-ticket.msg, in msg format, using aspose email cloud mcp | ||
email_get_disposable_is_disposable |
This tool determines whether a given email address is a disposable (temporary) address. 只读 |
address: str（必需）
|
| 提示：is user@mailinator.com a disposable email address? use aspose email cloud mcp | ||
email_get_config_discover |
The tool discovers email server configuration settings for a given email address without validating the discovered accounts. 只读 |
address: str（必需）, fast_processing: bool | None
|
| 提示：discover the mail server settings for jane@example.com using aspose email cloud mcp | ||
| 提示：quickly discover the mail server settings for jane@example.com using fast processing, using aspose email cloud mcp | ||
email_save_client_account |
The tool creates or updates an email client account file (*.account) in the specified storage location using the supplied credentials. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：save an email client account file named work.account for jane@example.com using aspose email cloud mcp | ||
| 提示：do a dry run of saving an email client account file named personal.account for jane@example.com using aspose email cloud mcp | ||
email_get_client_account |
Retrieves the email client account configuration stored in a specified file on Aspose Cloud storage. 只读 |
file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the settings stored in work.account using aspose email cloud mcp | ||
| 提示：show the settings stored in work.account from the accounts folder of my MyStorage storage using aspose email cloud mcp | ||
email_get_client_account_multi |
Retrieves a multi‑account email client file (must have the “.multi.account” extension) from Aspose Cloud storage. 只读 |
file_name: str（必需）, folder: str | None, storage: str | None
|
| 提示：show the accounts stored in team.multi.account using aspose email cloud mcp | ||
email_create_client_folder |
The tool creates a new mail folder in a specified email account. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：create a folder called Invoices in the work.account mailbox using aspose email cloud mcp | ||
| 提示：do a dry run of creating a folder called Receipts in the work.account mailbox using aspose email cloud mcp | ||
email_delete_client_folder |
Deletes a specified folder from a user's email account. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：delete the Old Newsletters folder from the work.account mailbox using aspose email cloud mcp | ||
| 提示：do a dry run of deleting the Spam Archive folder from the work.account mailbox using aspose email cloud mcp | ||
email_get_client_folder_list |
The tool retrieves the list of folders (or sub‑folders) for a specified email account. 只读 |
account: str（必需）, storage: str | None, account_storage_folder: str | None, parent_folder: str | None
|
| 提示：list the folders in the work.account mailbox using aspose email cloud mcp | ||
| 提示：list the subfolders of Projects in the work.account mailbox, with the account file in the accounts folder of my MyStorage storage, using aspose email cloud mcp | ||
email_get_client_message |
Retrieves a single email message from a specified email account (and optional folder) and returns it in the requested representation. 只读 |
message_id: str（必需）, account: str（必需）, folder: str | None, storage: str | None, account_storage_folder: str | None, type: str | None, format: str | None
|
| 提示：get message 42 from the work.account mailbox using aspose email cloud mcp | ||
| 提示：get message 42 from the Archive folder of the work.account mailbox as base64 data in eml format using aspose email cloud mcp | ||
| 提示：get message 42 from the work.account mailbox as a MAPI message using aspose email cloud mcp | ||
email_delete_client_message |
Deletes a specific email message from the user's mailbox. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：delete message 42 from the Inbox in the work.account mailbox using aspose email cloud mcp | ||
| 提示：do a dry run of deleting message 57 from the Inbox in the work.account mailbox using aspose email cloud mcp | ||
email_get_client_message_file |
Fetches a single email message from a specified account and returns it as a downloadable file in the chosen format. 只读 |
message_id: str（必需）, account: str（必需）, folder: str | None, storage: str | None, account_storage_folder: str | None, format: str | None
|
| 提示：download message 42 from work.account as a file using aspose email cloud mcp | ||
| 提示：download message 42 from the Archive folder of work.account as an eml file using aspose email cloud mcp | ||
email_append_client_message_file |
Adds an email message from a supplied file into a specified folder of a given email account. 演练模式 |
account: str（必需）, file: str（必需）, storage: str | None, account_storage_folder: str | None, format: str | None, folder: str | None, mark_as_sent: bool | None, content_base64: str | None, dry_run: bool
|
| 提示：add message.eml to the work.account mailbox using aspose email cloud mcp | ||
| 提示：add message.eml to the Sent folder of the work.account mailbox as an eml file and mark it as sent, using aspose email cloud mcp | ||
| 提示：do a dry run of adding this base64 content as message.eml to the work.account mailbox using aspose email cloud mcp | ||
email_get_client_message_list |
Retrieves a list of email messages from a specified folder in a given email account, optionally filtered by a query string and returned in a chosen representation. 只读 |
folder: str（必需）, account: str（必需）, query_string: str | None, storage: str | None, account_storage_folder: str | None, recursive: bool | None, type: str | None, format: str | None
|
| 提示：list the messages in the Inbox of the work.account mailbox using aspose email cloud mcp | ||
| 提示：search the Inbox of the work.account mailbox, including subfolders, for messages matching 'invoice' using aspose email cloud mcp | ||
| 提示：list the messages in the Inbox of the work.account mailbox as base64-encoded msg files using aspose email cloud mcp | ||
email_get_client_thread_list |
Get message threads from folder. All messages are partly fetched (without email body and some other fields). 只读 |
folder: str（必需）, account: str（必需）, storage: str | None, account_storage_folder: str | None, update_folder_cache: bool | None, messages_cache_limit: str | None
|
| 提示：list the conversation threads in the Inbox of work.account using aspose email cloud mcp | ||
| 提示：list the conversation threads in the Inbox of work.account, refreshing the folder cache and caching up to 500 messages, using aspose email cloud mcp | ||
email_get_client_thread_messages |
Retrieves all messages that belong to a given email thread, optionally scoped to a specific folder or storage location. 只读 |
thread_id: str（必需）, account: str（必需）, folder: str | None, storage: str | None, account_storage_folder: str | None
|
| 提示：show every message in thread 17 of the work.account mailbox using aspose email cloud mcp | ||
| 提示：show every message in thread 17 of the Inbox of the work.account mailbox using aspose email cloud mcp | ||
email_delete_client_thread |
Deletes an email thread identified by its ID, removing all messages contained in that thread. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：delete thread 17 from the work.account mailbox using aspose email cloud mcp | ||
| 提示：do a dry run of deleting thread 21 from the work.account mailbox using aspose email cloud mcp | ||
email_run_ai_bcr_parse_storage |
The tool parses one or more email image files stored in Aspose Cloud storage and creates corresponding vCard files in a specified output folder. 演练模式 |
request: dict[str, Any]（必需）, dry_run: bool
|
| 提示：parse the business card images card1.jpg and card2.jpg in cloud storage into contacts using aspose email cloud mcp | ||
| 提示：do a dry run of parsing the business card image card3.jpg in cloud storage into a contact using aspose email cloud mcp | ||
email_run_ai_bcr_parse |
The tool extracts contact information from an uploaded image and returns it as structured vCard document models. 演练模式 |
file: str（必需）, countries: str | None, languages: str | None, is_single: bool | None, content_base64: str | None, dry_run: bool
|
| 提示：extract the contact from the business card image card.jpg as a vcard using aspose email cloud mcp | ||
| 提示：extract the contact from the single business card in card.jpg, expecting US cards in English, using aspose email cloud mcp | ||
| 提示：do a dry run of extracting the contact from this base64 content, a business card image named card.jpg, using aspose email cloud mcp | ||
email_get_ai_name_parse |
Parse a personal name into its constituent components (e.g., given name, middle name, surname, title, etc.) using the Aspose Cloud AiName service. 只读 |
name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：split 'Dr. Maria Elena Garcia' into title, given name and surname using aspose email cloud mcp | ||
| 提示：split 'Jose Maria Garcia' into its parts, as a Spanish name from Spain, using aspose email cloud mcp | ||
| 提示：split 'Мария Иванова' into its parts, in Cyrillic script, utf-8 encoded, in a formal style, using aspose email cloud mcp | ||
email_get_ai_name_genderize |
This tool invokes the Aspose Cloud AI Name genderize endpoint to infer the most likely gender for a given personal name. 只读 |
name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：what is the most likely gender for the name Andrea? use aspose email cloud mcp | ||
| 提示：what is the most likely gender for the name Andrea as an Italian name from Italy? use aspose email cloud mcp | ||
email_get_ai_name_complete |
This tool returns up to k suggested full names that best complete the supplied name prefix. 只读 |
name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：suggest full names that complete 'Joh' using aspose email cloud mcp | ||
| 提示：suggest English full names from the United States that complete 'Joh' using aspose email cloud mcp | ||
email_get_ai_name_format |
Formats a given person’s name into the correct case and order using optional language, region, script, style, and formatting settings, and returns the formatted name. 只读 |
name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, format: str | None, style: str | None
|
| 提示：format the name 'garcia, MARIA' with correct case and order using aspose email cloud mcp | ||
| 提示：format the name 'garcia, MARIA' as a Spanish name from Spain in the 'first last' format using aspose email cloud mcp | ||
email_get_ai_name_expand |
This tool expands a given personal name into a list of possible alternative spellings or forms based on optional language, location, encoding, script, and style settings. 只读 |
name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：give alternative forms and spellings of the name 'Bob' using aspose email cloud mcp | ||
| 提示：give alternative English forms of the name 'Bob' used in the United States using aspose email cloud mcp | ||
email_get_ai_name_match |
This tool compares two personal names and returns a similarity assessment. 只读 |
name: str（必需）, other_name: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：how similar are the names 'Jon Smith' and 'John Smyth'? use aspose email cloud mcp | ||
| 提示：how similar are the English names 'Jon Smith' and 'John Smyth' for the United States? use aspose email cloud mcp | ||
email_get_ai_name_parse_email_address |
This tool extracts a person’s name from a given email address using Aspose Cloud’s AiName parsing service. 只读 |
email_address: str（必需）, language: str | None, location: str | None, encoding: str | None, script: str | None, style: str | None
|
| 提示：extract the person's name from john.smith@example.com using aspose email cloud mcp | ||
| 提示：extract the person's English name from jsmith.maria@example.es, assuming it is from Spain, using aspose email cloud mcp | ||
email_get_storage_file |
The tool downloads a file from Aspose Cloud Email storage and returns the file’s binary contents. 只读 |
path: str（必需）, storage_name: str | None, version_id: str | None
|
| 提示：download message.eml from email storage using aspose email cloud mcp | ||
| 提示：download version 3f2a of archive/message.eml from my MyStorage storage using aspose email cloud mcp | ||
email_delete_storage_file |
Deletes a file stored in Aspose Cloud at the specified path. 演练模式 |
path: str（必需）, storage_name: str | None, version_id: str | None, dry_run: bool
|
| 提示：delete old-message.eml from email storage using aspose email cloud mcp | ||
| 提示：do a dry run of deleting version 3f2a of archive/old-message.eml from my MyStorage storage using aspose email cloud mcp | ||
email_update_storage_file_copy |
Copy file 演练模式 |
src_path: str（必需）, dest_path: str（必需）, src_storage_name: str | None, dest_storage_name: str | None, version_id: str | None, dry_run: bool
|
| 提示：copy message.eml to backup/message.eml using aspose email cloud mcp | ||
| 提示：copy message.eml from my SourceStorage storage to backup/message.eml in my BackupStorage storage using aspose email cloud mcp | ||
| 提示：do a dry run of copying version 3f2a of message.eml to backup/message.eml using aspose email cloud mcp | ||
email_update_storage_file_move |
Moves a file from a source location to a destination location within Aspose Cloud storage, optionally specifying different storage names or a file version. 演练模式 |
src_path: str（必需）, dest_path: str（必需）, src_storage_name: str | None, dest_storage_name: str | None, version_id: str | None, dry_run: bool
|
| 提示：move message.eml to archive/message.eml using aspose email cloud mcp | ||
| 提示：do a dry run of moving message.eml from my SourceStorage storage to archive/message.eml in my ArchiveStorage storage using aspose email cloud mcp | ||
email_get_storage_folder |
Retrieves a list of all files and sub‑folders that exist inside a given email storage folder. 只读 |
path: str（必需）, storage_name: str | None
|
| 提示：list the files and subfolders in the inbox-export folder using aspose email cloud mcp | ||
| 提示：list the files and subfolders in the inbox-export folder of my MyStorage storage using aspose email cloud mcp | ||
email_update_storage_folder |
Creates a new folder in the specified Aspose Cloud email storage at the given path. 演练模式 |
path: str（必需）, storage_name: str | None, dry_run: bool
|
| 提示：create a folder called archive-2026 in email storage using aspose email cloud mcp | ||
| 提示：do a dry run of creating the folder archive-2027 in my MyStorage storage using aspose email cloud mcp | ||
email_delete_storage_folder |
Deletes a specified folder from Aspose Cloud email storage. 演练模式 |
path: str（必需）, storage_name: str | None, recursive: bool | None, dry_run: bool
|
| 提示：delete the temp folder from email storage using aspose email cloud mcp | ||
| 提示：do a dry run of deleting the temp folder and everything in it from my MyStorage storage using aspose email cloud mcp | ||
email_update_storage_folder_copy |
Copies a folder from a source path to a destination path in Aspose Email Cloud storage. 演练模式 |
src_path: str（必需）, dest_path: str（必需）, src_storage_name: str | None, dest_storage_name: str | None, dry_run: bool
|
| 提示：copy the inbox-export folder to inbox-backup using aspose email cloud mcp | ||
| 提示：do a dry run of copying the inbox-export folder from my SourceStorage storage to inbox-backup in my BackupStorage storage using aspose email cloud mcp | ||
email_update_storage_folder_move |
Moves an existing folder from one location to another within Aspose Cloud storage. 演练模式 |
src_path: str（必需）, dest_path: str（必需）, src_storage_name: str | None, dest_storage_name: str | None, dry_run: bool
|
| 提示：move the inbox-export folder into the archive folder using aspose email cloud mcp | ||
| 提示：do a dry run of moving the inbox-export folder from my SourceStorage storage into archive in my ArchiveStorage storage using aspose email cloud mcp | ||
email_get_storage_exist |
The tool checks whether a specified Aspose Cloud storage container exists. 只读 |
storage_name: str（必需）
|
| 提示：does the storage named MyStorage exist? use aspose email cloud mcp | ||
email_get_storage_disc |
The tool returns the current disc usage statistics for Aspose.Email cloud storage. 只读 |
storage_name: str | None
|
| 提示：how much disc space is used in email storage? use aspose email cloud mcp | ||
| 提示：how much disc space is used in my MyStorage storage? use aspose email cloud mcp | ||
email_get_storage_version |
Retrieves the complete version history for a specified file stored in Aspose Email Cloud. 只读 |
path: str（必需）, storage_name: str | None
|
| 提示：show the version history of message.eml using aspose email cloud mcp | ||
| 提示：show the version history of archive/message.eml in my MyStorage storage using aspose email cloud mcp | ||
每个服务器还内置四个共享文件工具（上传、下载、列出和删除），因此单个服务器即可完成完整的上传、处理、下载工作流。
探索更多