Elasticemail MCP Server

🚀 郵件管理系統

本項目是一個郵件管理系統，可與 Elastic Email API 連接，實現郵件活動管理、聯繫人管理、模板管理等功能，藉助 Copilot 集成還能更高效地使用。

🚀 快速開始

環境要求

• .NET SDK 10 或更高版本。
• 需連接到 Elastic Email API 才能正常工作。
• 為 HTTP 開放端口 5001。

Copilot 集成步驟

1. 使用 VS Code。
2. 打開聊天窗口。
3. 選擇“Agent”模式。
4. 使用 settings.json 文件連接到 mcp 服務器（打開包含此文件的文件夾）。
5. 你應該會在“servers”附近看到小控件。
6. 添加一個設置文件作為代理的上下文。
7. 打開“Select tools...”窗口（點擊螺絲刀和扳手圖標）。
8. 找到 mcp 服務器並確保選擇了所有工具。
9. 點擊“Start”。

代理的示例配置

"my-server-unique-number": {
    "url": "http://localhost:5001/",
    "headers": {
        "X-Auth-Token": <api_key>
    }
}

✨ 主要特性

本系統提供了豐富的工具，用於管理郵件活動、聯繫人、模板等，具體如下：

• 健康檢查：
  • HealthCheck.IsReady：檢查 Elastic Email API 服務器是否可用並響應。
• 活動管理：
  • CampaignManagement.CreateCampaign：在系統中創建活動。
  • CampaignManagement.ListCampaigns：列出現有活動。
  • CampaignManagement.GetCampaign：獲取活動詳情。
  • CampaignManagement.Pause：停止活動處理。
  • CampaignManagement.UpdateCampaign：更改活動數據（可通過狀態編輯重新啟動）。
  • CampaignManagement.GetAllCampaignStatistics：獲取所有活動的統計數據，如打開郵件的數量。
  • CampaignManagement.GetCampaignStatistics：獲取指定活動（按名稱）的統計數據，如打開、點擊等。
• 分段管理：
  • SegmentsManagement.CreateSegment：創建新的分段。
  • SegmentsManagement.GetSegments：獲取現有分段的列表。
  • SegmentsManagement.GetSegment：按名稱獲取分段。
• 模板管理：
  • TemplateManagement.FetchTemplate：獲取模板詳情。
  • TemplateManagement.FetchTemplates：獲取模板列表，可按類型和可訪問性過濾。
• 郵件發送：
  • EmailSending.SendBulkEmails：向多個用戶發送郵件（可使用聯繫人列表），可提供內容或使用模板。
  • EmailSending.SendTransactionalEmail：向聯繫人發送郵件，可提供模板。
• 聯繫人管理：
  • ContactsManagement.FetchContacts：獲取聯繫人列表。
  • ContactsManagement.FetchContactHistory：獲取聯繫人歷史記錄（如果啟用）。
  • ContactsManagement.FetchLists：獲取所有聯繫人列表。
  • ContactsManagement.FetchList：獲取聯繫人列表詳情。
  • ContactsManagement.FetchListContacts：獲取指定列表（按名稱）中的聯繫人。
  • ContactsManagement.AddContactToList：將聯繫人添加到列表。
  • ContactsManagement.RemoveContactsToList：從指定列表（按名稱）中移除聯繫人。
  • ContactsManagement.CreateList：創建新的聯繫人列表。
  • ContactsManagement.AddContact：添加新聯繫人。
  • ContactsManagement.DeleteContacts：刪除聯繫人（提供電子郵件地址）。
  • ContactsManagement.UploadContacts：從文件中上傳並添加新聯繫人。