SendGrid MCP Server

SendGrid MCP Server

site icon
2025.02.26 9
TypeScript电子邮件营销联系人管理交流协作
SendGrid MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 SendGrid 营销 API 的访问,用于电子邮件营销和联系人管理。它支持 SendGrid 的 v3 API,专注于动态模板、营销 API v3 和批量邮件发送功能。
View on GitHub

Overview

基本能力

产品定位

SendGrid MCP Server 是一个专注于电子邮件营销和联系人管理的服务,通过 SendGrid 的 API 提供高效的邮件发送、联系人管理和模板创建功能。

核心功能

  1. 联系人管理:包括列出、添加、删除联系人以及获取特定列表中的联系人。
  2. 列表管理:创建、删除联系人列表,以及向列表中添加或移除联系人。
  3. 邮件发送:支持单个邮件发送和批量邮件发送到联系人列表。
  4. 模板管理:创建、列出、获取和删除动态邮件模板。
  5. 分析和验证:获取邮件统计数据和验证电子邮件地址。
  6. 账户管理:列出已验证的发件人和退订组。

适用场景

  1. 电子邮件营销活动。
  2. 联系人管理和分组。
  3. 动态邮件模板的创建和使用。
  4. 邮件发送统计和分析。

工具列表

  1. list_contacts:列出所有联系人。
  2. add_contact:添加联系人。
  3. delete_contacts:删除联系人。
  4. get_contacts_by_list:获取列表中的联系人。
  5. list_contact_lists:列出所有联系人列表。
  6. create_contact_list:创建联系人列表。
  7. delete_list:删除联系人列表。
  8. add_contacts_to_list:向列表中添加联系人。
  9. remove_contacts_from_list:从列表中移除联系人。
  10. send_email:发送单个邮件。
  11. send_to_list:批量发送邮件到列表。
  12. create_template:创建动态模板。
  13. list_templates:列出所有模板。
  14. get_template:获取模板。
  15. delete_template:删除模板。
  16. get_stats:获取邮件统计数据。
  17. validate_email:验证电子邮件地址。
  18. list_verified_senders:列出已验证的发件人。
  19. list_suppression_groups:列出所有退订组。

常见问题解答

  1. API 支持:仅支持 SendGrid 的 v3 API,不支持旧版功能。
  2. 邮件发送限制:发送邮件到列表时必须提供退订组 ID 或自定义退订链接。
  3. 发件人验证:发件人电子邮件地址必须经过验证才能使用。
  4. 数据一致性:SendGrid API 是“最终一致性”的,数据更改可能不会立即显示。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 克隆仓库:
git clone https://github.com/Garoth/sendgrid-mcp.git

安装教程

  1. 进入项目目录:
cd sendgrid-mcp
  1. 安装依赖:
npm install
  1. 获取 SendGrid API 密钥并配置到 Cline MCP 设置文件中。

调试方式

  1. 复制环境示例文件:
cp .env.example .env
  1. 编辑 .env 文件并添加 SendGrid API 密钥。
  2. 运行测试:
npm test
  1. 构建项目:
npm run build

许可证

该项目遵循 MIT 开源许可条款。