JinDaGe - Brevo MCP Details

article

README

🚀 Brevo MCP (多通道平台)

Brevo MCP是专门为Brevo API设计的模型上下文协议（MCP）实现，它能让Claude及其他AI助手与之无缝集成，为用户带来更便捷的使用体验。

✨ 主要特性

✉️ 邮件管理
- 可轻松发送事务邮件，满足各种业务通知需求。
- 能精准跟踪邮件投递情况和相关事件，让你随时掌握邮件动态。
- 提供美观的邮件模板，使邮件内容更加专业和吸引人。
👥 联系人管理
- 支持创建和更新联系人信息，方便维护联系人列表。
- 可以灵活管理自定义属性，满足多样化的信息记录。
- 能够跟踪联系人活动，深入了解客户行为。

🚀 快速开始

在Claude Desktop中的使用

将以下内容添加到您的Claude Desktop配置文件中（通常为~/.config/claude-next/config.json）：

{
  "MCPServers": {
    "brevo": {
      "command": ["npx", "@apicolet/brevo-mcp"],
      "config": {
        "apiKey": "your-brevo-api-key-here"
      }
    }
  }
}

重启Claude Desktop以加载配置。

完成以上步骤后，您就可以直接在Claude对话中使用Brevo功能啦。

💻 使用示例

发送邮件

// 发送事务邮件
const result = await mcp.brevo.send_email({
  to: [{ 
    email: "recipient@example.com",
    name: "John Doe"
  }],
  subject: "来自Claude的问候!",
  htmlContent: "<h1>欢迎!</h1><p>这是一封测试邮件。</p>"
});

管理联系人

// 获取联系人详情
const contact = await mcp.brevo.get_contact("john@example.com");

// 更新联系人属性
await mcp.brevo.update_contact(contact.id, {
  attributes: {
    FIRSTNAME: "John",
    LASTNAME: "Doe",
    COMPANY: "Acme Inc"
  }
});

📚 详细文档

可用工具

MCP提供了几个可以在Claude中使用的工具：

get_contact：通过邮箱或ID获取联系人详情
update_contact：更新联系人属性
create_attribute：创建新的联系人属性
send_email：发送事务邮件
get_email_events：跟踪邮件投递和互动

📦 安装指南

开发设置

克隆仓库：

git clone https://github.com/apicolet/brevo-mcp.git
cd brevo-mcp

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

运行测试

npm test

贡献

欢迎贡献！请随意提交Pull Request。

📄 许可证

本项目采用MIT许可证。

🔧 技术细节

安全

⚠️ 重要提示
- 请务必保持API密钥安全，绝不要在版本控制中提交。
- 建议使用环境变量或Claude Desktop的安全配置部分存储敏感数据。
- MCP服务器仅处理Claude和Brevo之间的通信，不会本地存储任何数据。

Brevo