Sendgrid

🚀 發送Grid MCP服務器

本項目提供了一個發送Grid MCP服務器，可幫助你更方便地使用發送Grid的相關功能，實現郵件發送等操作。

🚀 快速開始

要使用本項目，你需要先完成安裝和配置，以下是詳細步驟。

📦 安裝指南

git clone https://github.com/Garoth/sendgrid-mcp.git
cd sendgrid-mcp
npm install

📚 詳細文檔

配置

1. 獲取你的發送Grid API密鑰：

   • 登錄到你的發送Grid賬戶
   • 轉到設置 > API密鑰
   • 創建一個新的API密鑰，權限設為全訪問
   • 安全地保存該API密鑰，因為一旦生成將無法再次查看

2. 將其添加到VSCode中的Cline MCP設置文件（例如：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "sendgrid": {
      "command": "node",
      "args": ["/path/to/sendgrid-mcp/build/index.js"],
      "env": {
        "SENDGRID_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": [
        "list_contacts",
        "list_contact_lists",
        "list_templates",
        "list_single_sends",
        "get_single_send",
        "list_verified_senders",
        "list_suppression_groups",
        "get_stats",
        "validate_email"
      ]
    }
  }
}

⚠️ 重要提示

修改數據的工具（如發送郵件或刪除聯繫人）出於安全考慮，默認不啟用自動批准。

開發

設置測試

測試使用真實的API調用以確保準確響應。要運行測試：

1. 複製示例環境文件：

   cp .env.example .env
   

2. 編輯.env並添加你的發送Grid API密鑰：

   SENDGRID_API_KEY=your-api-key-here
   

   ⚠️ 重要提示

   .env文件被git忽略，以防止提交敏感信息。

3. 運行測試：

   npm test
   

構建

npm run build

重要說明

• 當向列表發送郵件時，必須提供suppression_group_id或custom_unsubscribe_url以符合電子郵件法規
• 發件人電子郵件地址必須在發送Grid中驗證後才能用於發送郵件
• 所有模板均作為動態模板創建，支持Handlebars語法（例如：{{variable_name}})
• 單個發送API用於所有批量郵件操作，因為它提供更好的跟蹤和管理功能
• 發送Grid API是“最終一致性”的 - 數據更改（如添加聯繫人或更新列表）可能在生成後不會立即顯示

📄 許可證

本項目採用MIT許可證。

發送Grid標誌版權歸Twilio所有