Getmailer MCP

🚀 GetMailer MCP 服務器

GetMailer MCP 服務器是一個基於 MCP（模型上下文協議）的服務器，專為 GetMailer 服務。它允許像 Claude 這樣的 AI 助手發送事務性電子郵件，為用戶提供了便捷的郵件發送解決方案。

🚀 快速開始

最快的啟動方式是直接通過 MCP 進行註冊：

1. 將 MCP 服務器添加到 Claude 桌面端（此時還不需要 API 密鑰）

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"]
    }
  }
}

2. 讓 Claude 為你註冊

"使用電子郵件 user@example.com 和密碼 MyPassword123 為我註冊 GetMailer"

3. Claude 將返回你的 API 密鑰。更新你的配置

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"],
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

4. 重啟 Claude 桌面端，開始發送電子郵件！

📦 安裝指南

npm install -g getmailer-mcp

🛠️ 已有用戶使用 Claude 桌面端的設置方法

如果你已經有 API 密鑰，將以下內容添加到你的 Claude 桌面端配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"],
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

或者，如果你是全局安裝的：

{
  "mcpServers": {
    "getmailer": {
      "command": "getmailer-mcp",
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

✨ 主要特性

可用工具

signup

直接通過 Claude 創建一個新的 GetMailer 賬戶。返回一個 API 密鑰併發送一封驗證電子郵件。

• 重要提示：在你可以發送電子郵件之前，必須驗證你的電子郵件。註冊後請檢查你的收件箱！
• 參數：
  • email（必需）：你的電子郵件地址（不能使用一次性電子郵件）
  • password（必需）：密碼（至少 8 個字符，必須包含大寫字母、小寫字母和數字）
  • name：你的姓名（可選）
• 示例：

使用我的電子郵件 developer@example.com 為我註冊 GetMailer

account_status

檢查你的賬戶狀態，包括電子郵件驗證、訂閱計劃和發送限制。

• 參數：無
• 返回值：
  • 電子郵件驗證狀態
  • 訂閱計劃和剩餘電子郵件數量
  • 已驗證的域名數量
  • 是否可以發送電子郵件
  • 任何必需的操作（驗證電子郵件、添加域名等）
• 示例：

檢查我的 GetMailer 賬戶狀態

send_email

發送一封事務性電子郵件。

• 參數：
  • from（必需）：發件人電子郵件地址
  • to（必需）：收件人地址數組
  • subject（必需）：電子郵件主題
  • html：HTML 內容
  • text：純文本內容
  • cc：抄送收件人
  • bcc：密送收件人
  • replyTo：回覆地址
  • templateId：模板 ID（代替 html/text）
  • variables：模板變量
• 示例：

從 hello@myapp.com 向 user@example.com 發送一封主題為 "Welcome!" 且 HTML 內容為 "<h1>Hello!</h1>" 的電子郵件

list_emails

列出已發送的電子郵件及其狀態信息。

• 參數：
  • limit：返回的電子郵件數量（默認值：20）
  • cursor：分頁遊標

get_email

獲取特定電子郵件的詳細信息，包括投遞事件。

• 參數：
  • id（必需）：電子郵件 ID

list_templates

列出可用的電子郵件模板。

create_template

創建一個新的電子郵件模板。

• 參數：
  • name（必需）：模板名稱
  • subject（必需）：主題行（可以包含 {{variables}}）
  • html（必需）：HTML 內容（可以包含 {{variables}}）
  • text：純文本內容

list_domains

列出已驗證的發送域名。

add_domain

添加一個新的發送域名。

• 參數：
  • domain（必需）：域名（例如，example.com）
• 返回需要配置的 DNS 記錄。

verify_domain

檢查一個域名是否已驗證。

• 參數：
  • id（必需）：域名 ID

get_analytics

獲取電子郵件分析和統計信息。

• 參數：
  • type："summary" 或 "daily"
  • days：每日統計的天數

list_suppression

列出被抑制的電子郵件地址。

• 參數：
  • limit：返回的條目數量

add_to_suppression

將電子郵件地址添加到抑制列表中。

• 參數：
  • emails（必需）：電子郵件地址數組
  • reason：MANUAL、BOUNCE 或 COMPLAINT

create_batch

創建一個批量電子郵件作業。

• 參數：
  • name（必需）：批量作業名稱
  • from（必需）：發件人地址
  • recipients（必需）：{to, variables} 對象數組
  • subject：電子郵件主題
  • html：HTML 內容
  • text：純文本內容
  • templateId：模板 ID
  • replyTo：回覆地址

list_batches

列出批量電子郵件作業。

get_batch

獲取批量作業的狀態和進度。

• 參數：
  • id（必需）：批量作業 ID

💻 使用示例

配置完成後，你可以向 Claude 提出以下請求：

• "從 notifications@myapp.com 向 user@example.com 發送一封電子郵件，告知他們的訂單已發貨"
• "列出我最近的電子郵件"
• "檢查電子郵件 abc123 的狀態"
• "創建一個用於重置密碼的電子郵件模板"
• "顯示我過去一週的電子郵件分析數據"
• "將 user@spam.com 添加到我的抑制列表中"

🔧 技術細節

環境變量

• GETMAILER_API_KEY：你的 GetMailer API 密鑰（註冊時可選，其他工具需要）
• GETMAILER_API_URL：自定義 API URL（默認值：https://getmailer.app）

獲取你的 API 密鑰

選項 1：通過 MCP 註冊（推薦）

直接從 Claude 使用 signup 工具，無需使用網頁瀏覽器！

選項 2：通過網頁註冊

1. 在 getmailer.app 上註冊
2. 轉到 API 密鑰 頁面
3. 創建一個新的 API 密鑰

📚 詳細文檔

• 文檔：getmailer.app/docs
• 問題反饋：GitHub 問題