返回 MCP 目录
public公开dns本地运行

Brevo

Brevo MCP是一个多通道平台协议实现,用于与Brevo API无缝集成,支持通过Claude等AI助手进行邮件和联系人管理。

article

README

🚀 Brevo MCP (多通道平台)

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

✨ 主要特性

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

🚀 快速开始

在Claude Desktop中的使用

  1. 将以下内容添加到您的Claude Desktop配置文件中(通常为~/.config/claude-next/config.json):
    {
      "MCPServers": {
        "brevo": {
          "command": ["npx", "@apicolet/brevo-mcp"],
          "config": {
            "apiKey": "your-brevo-api-key-here"
          }
        }
      }
    }
    
  2. 重启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:跟踪邮件投递和互动

📦 安装指南

开发设置

  1. 克隆仓库:
    git clone https://github.com/apicolet/brevo-mcp.git
    cd brevo-mcp
    
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    npm run build
    

运行测试

npm test

贡献

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

📄 许可证

本项目采用MIT许可证。

🔧 技术细节

安全

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端