Postmark MCP

🚀 Postmark MCP 服務器

這是一個用於 Postmark 電子郵件服務的 MCP 服務器實現，能夠通過簡潔的配置和安全的操作，幫助用戶高效地使用 Postmark 發送電子郵件。

✨ 主要特性

• 提供用於通過 Postmark 發送電子郵件的模型上下文協議（MCP）服務器。
• 可通過環境變量進行簡單配置。
• 具備全面的錯誤處理和優雅的關閉機制。
• 採用安全的日誌記錄方式（不暴露敏感數據）。
• 支持自動配置電子郵件跟蹤。

📦 安裝指南

環境要求

• Node.js（建議 v16 或更高版本）
• 一個 Postmark 賬戶和服務器令牌

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/ActiveCampaign/postmark-mcp
   cd postmark-mcp
   

2. 安裝依賴：

   npm install
   

3. 配置環境變量：

   • 將 .env.example 複製為 .env：

     cp .env.example .env
     

   • 編輯 .env 文件，填寫你的 Postmark 憑證和設置。

   變量	描述	是否必需
   POSTMARK_SERVER_TOKEN	你的 Postmark 服務器 API 令牌	是
   DEFAULT_SENDER_EMAIL	默認發件人電子郵件地址	是
   DEFAULT_MESSAGE_STREAM	Postmark 消息流（例如，'outbound'）	是

4. 啟動服務器：

   npm start
   

通過 Cursor 深度鏈接快速安裝

你可以通過點擊以下按鈕在 Cursor 中快速安裝此 MCP 服務器：

⚠️ 重要提示

點擊按鈕後，你需要：

1. 在 MCP 配置中設置 POSTMARK_SERVER_TOKEN。
2. 在 MCP 配置中設置 DEFAULT_SENDER_EMAIL。
3. 在 MCP 配置中設置 DEFAULT_MESSAGE_STREAM（默認為 "outbound"）。

📚 詳細文檔

Claude 和 Cursor MCP 配置示例

{
  "mcpServers": {
    "Postmark": {
      "command": "your-node-path", // 節點路徑
      "args": ["/Users/your-name/your-location/postmark-mcp/index.js"], // index.js 的實際路徑
      "env": {
        "POSTMARK_SERVER_TOKEN": "your-postmark-server-token",
        "DEFAULT_SENDER_EMAIL": "your-default-sender-email",
        "DEFAULT_MESSAGE_STREAM": "your-default-message-stream"
      }
    }
  }
}

工具參考

本節提供了 Postmark MCP 服務器工具的完整參考，包括每個工具的示例提示和預期有效負載。

目錄

• 電子郵件管理工具
  • sendEmail
  • sendEmailWithTemplate
• 模板管理工具
  • listTemplates
• 統計與跟蹤工具
  • getDeliveryStats

電子郵件管理工具

1. sendEmail

發送單封文本電子郵件。

示例提示：

使用 Postmark 向 recipient@example.com 發送一封主題為 "會議提醒" 的電子郵件，內容為 "別忘了我們明天下午 2 點的團隊會議。請帶上你的季度統計報告（也許還可以帶些零食）。"

預期有效負載：

{
  "to": "recipient@example.com",
  "subject": "會議提醒",
  "textBody": "別忘了我們明天下午 2 點的團隊會議。請帶上你的季度統計報告（也許還可以帶些零食）。",
  "htmlBody": "電子郵件正文的 HTML 版本", // 可選
  "from": "sender@example.com", // 可選，若未提供則使用 DEFAULT_SENDER_EMAIL
  "tag": "meetings" // 可選
}

響應格式：

電子郵件發送成功！
MessageID: message-id-here
To: recipient@example.com
Subject: 會議提醒

2. sendEmailWithTemplate

使用預定義模板發送電子郵件。

示例提示：

使用 Postmark 模板別名 "welcome" 向 customer@example.com 發送一封電子郵件，包含以下模板變量：
{
  "name": "John Doe",
  "product_name": "MyApp",
  "login_url": "https://myapp.com/login"
}

預期有效負載：

{
  "to": "customer@example.com",
  "templateId": 12345, // 必須提供 templateId 或 templateAlias 之一，但不能兩者都提供
  "templateAlias": "welcome", // 必須提供 templateId 或 templateAlias 之一，但不能兩者都提供
  "templateModel": {
    "name": "John Doe",
    "product_name": "MyApp",
    "login_url": "https://myapp.com/login"
  },
  "from": "sender@example.com", // 可選，若未提供則使用 DEFAULT_SENDER_EMAIL
  "tag": "onboarding" // 可選
}

響應格式：

模板電子郵件發送成功！
MessageID: message-id-here
To: recipient@example.com
Template: template-id-or-alias-here

模板管理工具

3. listTemplates

列出所有可用模板。

示例提示：

顯示我們 Postmark 賬戶中所有可用的電子郵件模板列表。

響應格式：

📋 找到 2 個模板：

• 基本模板
  - ID: 12345678
  - 別名: basic
  - 主題: 無

• 歡迎模板
  - ID: 02345679
  - 別名: welcome
  - 主題: 無

統計與跟蹤工具

4. getDeliveryStats

檢索電子郵件送達統計信息。

示例提示：

顯示我們從 2025 年 5 月 1 日到 2025 年 5 月 15 日 "營銷" 標籤的 Postmark 電子郵件送達統計信息。

預期有效負載：

{
  "tag": "marketing", // 可選
  "fromDate": "2025-05-01", // 可選，YYYY-MM-DD 格式
  "toDate": "2025-05-15" // 可選，YYYY-MM-DD 格式
}

響應格式：

電子郵件統計摘要

發送: 100 封電子郵件
打開率: 45.5%（45/99 封跟蹤的電子郵件）
點擊率: 15.2%（15/99 個跟蹤的鏈接）

時間段: 2025-05-01 至 2025-05-15
標籤: marketing

🔧 技術細節

自動配置

所有電子郵件自動配置如下：

• TrackOpens: true
• TrackLinks: "HtmlAndText"
• 消息流來自 DEFAULT_MESSAGE_STREAM 環境變量

錯誤處理

服務器實現了全面的錯誤處理：

• 驗證所有必需的環境變量。
• 在 SIGTERM 和 SIGINT 信號下優雅關閉。
• 對 API 調用進行適當的錯誤處理。
• 日誌中不暴露敏感信息。
• 統一錯誤消息格式。

日誌記錄

• 使用適當的日誌級別（正常操作使用 info，錯誤使用 error）。
• 日誌中不包含敏感信息。
• 提供清晰的操作狀態和結果。

有關 Postmark API 的更多信息，請訪問 Postmark 開發者文檔。