Email MCP

Email MCP是一個為AI代理添加電子郵件功能的簡單模型上下文協議服務器，支持POP3和SMTP協議，提供收發郵件及管理功能。

通信工具開發者工具 #郵件服務 #AI代理 #協議服務器 .Python

評分 : 2分

下載量 : 11.9K

更新時間 : 2025-04-23

打開站點

什麼是Email MCP?

Email MCP 是一個基於Model Context Protocol（MCP）的服務器，它為AI助手提供了強大的電子郵件功能，包括接收（POP3）和發送（SMTP）電子郵件的能力。

如何使用Email MCP?

通過簡單的配置，您可以將您的郵箱賬戶連接到Email MCP服務器，然後使用內置工具來讀取、發送和管理郵件。

適用場景

Email MCP特別適合需要與AI助手協同工作的團隊，例如自動處理郵件、報告生成或客戶服務響應。

主要功能

接收郵件

通過POP3協議獲取收件箱中的郵件，包括消息ID和郵件頭部信息。

讀取郵件內容

根據指定的郵件ID，獲取郵件的具體內容，包括純文本和HTML格式。

刪除郵件

根據郵件ID批量刪除已讀或未讀郵件。

發送文本郵件

通過SMTP協議發送純文本格式的郵件。

發送HTML郵件

通過SMTP協議發送富文本格式（HTML）的郵件。

優勢

無縫集成AI助手，提升工作效率。

支持多種郵件操作，包括讀取、發送和刪除。

配置簡單，易於部署。

支持HTML和純文本兩種郵件格式。

適用於多種應用場景，如客戶服務和自動化報告。

侷限性

需要在服務器上安裝和運行Python環境。

僅支持基於POP3和SMTP協議的傳統郵件服務。

對於高併發郵件操作可能性能有限。

需要管理員權限進行服務器配置。

如何使用

安裝配置

按照提供的安裝指南配置服務器環境，確保安裝了Python，並正確設置環境變量。

啟動服務器

啟動Email MCP服務器，確保POP3和SMTP服務正常運行。

測試郵件功能

使用提供的API測試郵件接收和發送功能。

使用案例

讀取郵件

使用pollEmails()函數獲取最新的郵件信息。

發送文本郵件

發送一封純文本郵件給多個收件人。

發送HTML郵件

發送一封帶有HTML內容的郵件。

常見問題

如何配置Email MCP服務器？

支持哪些郵件協議？

是否支持附件發送？

如何停止Email MCP服務器？

🚀 電子郵件 MCP

電子郵件 MCP 是一款簡單的模型上下文協議（MCP）服務器，它為 AI 代理增添了電子郵件功能，支持 POP3 和 SMTP 協議，能讓 AI 代理輕鬆實現郵件的收發操作。

🚀 快速開始

本項目主要為 AI 代理提供電子郵件功能，通過配置相應的電子郵件賬戶信息，AI 代理可以使用一系列工具來實現郵件的接收、發送、刪除等操作。

✨ 主要特性

為 AI 代理添加電子郵件功能，支持 POP3 和 SMTP 協議。
提供多種工具函數，方便對郵件進行管理，如獲取郵件列表、獲取指定郵件內容、刪除郵件、發送純文本郵件和 HTML 郵件等。

📦 安裝指南

要在 Claude Desktop 上安裝，需要在開發者配置文件中添加以下內容：

{
    "mcpServers": {
        "mcp_email": {
            "command": "uv",
            "args": [
                "--directory",
                "/Absolute/path/to/server/directory",
                "run",
                "main.py"
            ],
            "env": {
                "EMAIL_USER": "電子郵件賬戶用戶名",
                "EMAIL_PASS": "電子郵件賬戶密碼",
                "POP3_SERVER": "POP3 服務器地址",
                "POP3_PORT": "POP3 服務器端口號",
                "SMTP_SERVER": "SMTP 服務器地址",
                "SMTP_PORT": "SMTP 服務器端口號"
            }
        }
    }
}

⚠️ 重要提示

第二個參數應為 MCP_EMAIL 文件夾的絕對路徑。對於 Windows 用戶，假設 Python 已經設置在 Path 變量中。對於 Windows 安裝，反斜槓需要轉義。

環境變量應包含以便通過 POP3 和 SMTP 接收和發送電子郵件。

💻 使用示例

基礎用法

以下是連接的 LLM 可以使用的工具函數及其使用說明：

pollEmails()：返回當前存儲在選定郵箱中的所有郵件的消息 ID 和頭信息。該函數沒有輸入，返回一個包含字典對象的 list。

# 獲取所有郵件的消息 ID 和頭信息
email_list = pollEmails()
print(email_list)

getEmailsById(ids: list)：返回指定 ID 的郵件消息 ID 和正文內容。唯一輸入是需要獲取的所有郵件的 ID 列表，函數返回一個包含字典對象的 list。

# 獲取指定 ID 的郵件內容
ids = ['1', '2', '3']
email_content = getEmailsById(ids)
print(email_content)

deleteEmailsById(ids: list)：根據 ID 刪除當前收件箱中的電子郵件。注意：刪除任何郵件都會無效當前 ID 的順序——因此最好提示模型在最後執行此操作。函數沒有輸出。

# 刪除指定 ID 的郵件
ids = ['1', '2', '3']
deleteEmailsById(ids)

sendTextEmail(fromAddress: str, toAddresses: list, subject: str, body: str)：通過 SMTP 發送一條純文本格式的電子郵件。輸入依次為：發件人地址、收件人地址列表、主題文本、郵件正文內容。函數沒有輸出。

# 發送純文本郵件
from_address = 'sender@example.com'
to_addresses = ['recipient1@example.com', 'recipient2@example.com']
subject = 'Test Email'
body = 'This is a test email.'
sendTextEmail(from_address, to_addresses, subject, body)

sendHtmlEmail(fromAddress: str, toAddresses: list, subject: str, body: str)：通過 SMTP 發送一條 HTML 格式的電子郵件。輸入依次為：發件人地址、收件人地址列表、主題文本、HTML 格式的內容正文。函數沒有輸出。

# 發送 HTML 郵件
from_address = 'sender@example.com'
to_addresses = ['recipient1@example.com', 'recipient2@example.com']
subject = 'Test HTML Email'
body = '<html><body><h1>This is a test HTML email.</h1></body></html>'
sendHtmlEmail(from_address, to_addresses, subject, body)

高級用法

在實際應用中，可以結合多個工具函數實現更復雜的郵件管理功能。例如，先獲取所有郵件的 ID，然後篩選出需要的郵件 ID，再獲取這些郵件的內容，最後刪除這些郵件。

# 獲取所有郵件的消息 ID 和頭信息
email_list = pollEmails()
# 篩選出需要的郵件 ID
selected_ids = []
for email in email_list:
    if 'important' in email['subject'].lower():
        selected_ids.append(email['id'])
# 獲取這些郵件的內容
email_content = getEmailsById(selected_ids)
print(email_content)
# 刪除這些郵件
deleteEmailsById(selected_ids)