Mailchimp MCP服务器
用于Mailchimp Marketing API v3.0的完整模型上下文协议(MCP)服务器,带有104+个工具和15+个React UI应用程序。
🚀 特性
104+MCP工具
全面报道Mailchimp Marketing API v3.0:
- 活动 (15个工具):创建、管理、发送、安排和测试电子邮件活动
- 列表/观众 (14个工具):管理列表、细分市场、兴趣类别和增长分析
- 成员 (12个工具):添加、更新、标记和跟踪列表订阅者
- 电子商务 (28个工具):管理商店、产品、订单、购物车、客户和促销代码
- 自动化 (10个工具):管理自动化工作流程和电子邮件
- 报告 (8个工具):访问活动分析、点击跟踪和绩效数据
- 登录页 (8个工具):创建和管理登录页面
- 模板 (6个工具):管理电子邮件模板
- 搜索 (2个工具):搜索活动和成员
- 标签 (1个工具):搜索和管理标签
15+React UI应用程序
用于视觉交互的漂亮、深色主题的React应用程序:
- 活动仪表板 -查看和管理所有活动
- 观众经理 -全面的受众/列表管理
- 用户网格 -可搜索的用户表
- 分段生成器 -创建和管理细分市场
- 模板库 -浏览和使用电子邮件模板
- 自动化流程 -管理自动化工作流程
- 活动分析 -详细的活动绩效指标
- A/B测试结果 -比较A/B测试结果
- 电子邮件预览 -预览活动电子邮件
- 标签管理器 -组织和应用标签
- 落地页构建工具 -创建登录页面
- 内容管理员 -管理电子邮件内容
- 生长曲线图 -可视化观众随时间的增长
- 发送时间优化器 -找到最佳发送时间
- 列出健康监视器 -跟踪列表健康指标
- 电子商务仪表板 -管理商店和产品
- 促销代码管理器 -创建和跟踪促销代码
📦 安装
npm install
npm run build🔧 配置
将Mailchimp API密钥设置为环境变量:
export MAILCHIMP_API_KEY="your-api-key-us19"您的API密钥格式: xxxxxxxxxxxxxxxxxxxxx-datacenter (例如。, abc123-us19)
您可以从Mailchimp帐户获取您的API密钥→ 额外内容→ API密钥
🎯 用法
作为MCP服务器
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mailchimp": {
"command": "node",
"args": ["/path/to/servers/mailchimp/dist/index.js"],
"env": {
"MAILCHIMP_API_KEY": "your-api-key-us19"
}
}
}
}独立
npm start📚 API覆盖范围
活动管理
- 创建活动(常规、A/B拆分、RSS、变量)
- 设置HTML/模板内容
- 发送、安排、暂停、恢复活动
- 发送测试电子邮件
- 复制活动
- 获取发送清单
受众/列表管理
- 创建和管理受众
- 添加/更新/删除成员(支持批处理操作)
- 创建分段(静态、已保存、模糊)
- 管理兴趣类别和组
- 跟踪增长历史
成员管理
- 使用合并字段添加/更新成员
- 标签管理(添加/删除标签)
- 跟踪会员活动和目标
- 批量订阅操作
- VIP会员指定
自动化工作流程
- 列出所有自动化
- 暂停/启动工作流
- 管理自动化电子邮件
- 队列管理
分析和报告
- 活动绩效报告
- 点击跟踪
- 开放费率详细信息
- 域性能分析
- A/B测试结果
- 每位订阅者的电子邮件活动
电子商务
- 店铺管理
- 产品目录(变体、SKU、库存)
- 订单跟踪
- 购物车弃置
- 客户管理
- 促销规则和代码
模板和登录页
- 模板库
- 创建自定义模板
- 登录页面生成器
- 发布/取消发布页面
🎨 React应用程序
所有应用程序都使用与Tailwind CSS一致的深色主题:
- 背景
bg-gray-900 - 卡:
bg-gray-800随着border-gray-700 - 口音:蓝色(
blue-400,blue-600)和绿色(green-400,green-600) - 排版:白色文本,灰色变体,用于层次结构
运行单个应用程序
cd src/ui/react-app/campaign-dashboard
npm install
npm run dev🔐 认证
服务器使用Mailchimp的API进行HTTP基本身份验证:
- 用户名:
anystring(Mailchimp忽略了这一点) - 密码:您的API密钥
⚡ 速率限制
Mailchimp执行速率限制(通常为每秒10个请求)。客户端自动:
- 跟踪速率限制标头
- 达到限制时等待
- 重置时间后恢复
📖 工具示例
创建活动
{
"type": "regular",
"recipients": {
"list_id": "abc123"
},
"settings": {
"subject_line": "Welcome to our newsletter!",
"from_name": "Your Company",
"reply_to": "hello@yourcompany.com",
"title": "Welcome Campaign"
}
}添加订阅者
{
"list_id": "abc123",
"email_address": "subscriber@example.com",
"status": "subscribed",
"merge_fields": {
"FNAME": "John",
"LNAME": "Doe"
}
}获取活动报告
{
"campaign_id": "abc123"
}🧪 测试
npm run typecheck # TypeScript type checking
npm test # Run tests (if configured)🏗️ 建筑
mailchimp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── clients/
│ │ └── mailchimp.ts # Mailchimp API client
│ ├── tools/
│ │ ├── campaigns-tools.ts
│ │ ├── lists-tools.ts
│ │ ├── members-tools.ts
│ │ ├── automations-tools.ts
│ │ ├── templates-tools.ts
│ │ ├── reports-tools.ts
│ │ ├── landing-pages-tools.ts
│ │ ├── ecommerce-tools.ts
│ │ ├── tags-tools.ts
│ │ └── search-tools.ts
│ ├── types/
│ │ └── index.ts # TypeScript type definitions
│ └── ui/
│ └── react-app/ # 15+ React applications
│ ├── campaign-dashboard/
│ ├── audience-manager/
│ ├── subscriber-grid/
│ └── ... (12+ more apps)
├── dist/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md📄 许可证
麻省理工学院
🤝 贡献
欢迎投稿!请阅读我们的投稿指南并提交PR。
📞 支持
- Mailchimp API文档
- MCP文件
- 问题:GitHub问题
🔗 相关
______________________________________________________________________
内置于❤️ 对于MCP社区
