Mailchimpmcp V0

Mailchimp MCP服务器

用于将Mailchimp与Claude Desktop集成的模型上下文协议（MCP）服务器。

⚠️ 安全和隐私声明

重要： 此MCP服务器将个人数据暴露给Claude AI和Claude Desktop：

• 电子邮件地址和会员信息通过工具响应发送给Claude AI
• Claude Desktop在您的设备上本地存储对话历史记录
• 仅适用于包含非敏感数据的帐户
• 启用PII屏蔽(MAILCHIMP_MASK_PII=true)保护个人信息
• 审查 安全.md 有关详细的安全信息

快速开始

💡 Mailchimp MCP新手？ 看 安装.md 有关详细的安装说明和故障排除。

🚀 安装选项

选项1:macOS安装程序应用程序（建议用于macOS）

从下载DMG文件 :

1. 下载 MailchimpMCPInstaller.dmg
2. 打开DMG文件
3. 双击 MailchimpMCPInstaller.app
4. 按照安装向导进行操作
5. 提示时输入Mailchimp API密钥
6. 重新启动克劳德桌面

安装程序将：

• ✅ 检查先决条件（Node.js、npm）
• ✅ 全局安装软件包
• ✅ 在浏览器中启动设置UI
• ✅ 自动配置克劳德桌面
• ✅ 验证Claude Desktop是否会自动启动Mailchimp MCP

卸载程序： DMG还包括 MailchimpMCPUninstaller.app 以完全删除Mailchimp MCP和所有相关数据。

选项2：命令行（所有平台）

对于macOS：

curl -fsSL https://raw.githubusercontent.com/alien-lifestyles/mailchimp-mcp-alien-lifestyles/main/install.sh | bash

对于所有平台（使用npx）：

npx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-install

手动安装：

npm install -g @alien-lifestyles/mailchimp-mcp && mailchimp-mcp-setup

📝 分步安装

步骤1：安装

npm install -g @alien-lifestyles/mailchimp-mcp

步骤2：运行安装程序

mailchimp-mcp-setup

或者，如果在本地安装：

npm run setup

步骤3：配置

设置UI将在浏览器中打开 http://localhost:3000.输入：

• ✅ 您的Mailchimp API密钥（必需）
• ✅ 服务器前缀（从API密钥自动检测）
• ⭐ 许可证密钥（可选-用于付费功能）
• 🔒 隐私设置（建议使用PII屏蔽）

步骤4:重新启动克劳德桌面

保存配置后，完全重新启动Claude Desktop以使更改生效。

第五步：测试

问克劳德：“你能运行mc_ping吗？”以验证连接。

🔧 手动配置（高级）

如果您更喜欢手动设置，请创建 .env 文件：

# Required
MAILCHIMP_API_KEY=your_api_key_here-us9
MAILCHIMP_SERVER_PREFIX=us9

# Optional
MAILCHIMP_LICENSE_KEY=ALIEN-XXXX-XXXX-XXXX
MAILCHIMP_MASK_PII=true

然后在以下位置手动编辑Claude Desktop配置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

添加：

{
  "mcpServers": {
    "mailchimp-mcp": {
      "command": "node",
      "args": ["/path/to/@alien-lifestyles/mailchimp-mcp/dist/index.js"],
      "cwd": "/path/to/@alien-lifestyles/mailchimp-mcp",
      "env": {
        "MAILCHIMP_API_KEY": "your_api_key_here-us9",
        "MAILCHIMP_SERVER_PREFIX": "us9",
        "MAILCHIMP_MASK_PII": "true"
      }
    }
  }
}

免费与付费版本

免费版本（默认）

• 对受众、活动和报告的只读访问
• 5营销人员提示
• 无写入操作
• 无需许可证密钥

付费版本

• 完全读/写访问
• 所有提示（CSM、营销人员、企业主）
• 创建活动、模板、受众
• 文件管理器集成
• 需要来自的许可证密钥 alienlifestyles.com

可用工具

阅读工具

编写工具（仅限付费）

查询示例

• “列出我的Mailchimp受众”
• “我有多少订阅者？”
• “显示我最近的活动”
• “我表现最好的竞选活动是什么？”
• “检查我的域身份验证状态”

看 使用_CASES.md 更多示例。

环境变量

故障排除

API密钥无效

• 验证API密钥在Mailchimp中是否正确和有效
• 确保数据中心前缀匹配（例如。， us9 在关键和 MAILCHIMP_SERVER_PREFIX)
• 使用完整的、未屏蔽的API密钥，包括数据中心后缀

Claude桌面连接问题

• 验证中的路径 claude_desktop_config.json 是正确的
• 确保 dist/index.js 存在（运行 npm run build)
• 检查克劳德桌面日志：设置→ 开发者→ 查看日志
• 配置更改后重新启动Claude Desktop

发展

npm run dev           # Development mode with watch
npm run build         # Build project
npm start             # Run built server
npm run setup         # Launch setup UI
npm run build:installer  # Build macOS installer and uninstaller apps (requires Xcode)

安全

• 永远不要承诺你的 .env 文件
• 启用PII屏蔽(MAILCHIMP_MASK_PII=true)
• 尽可能使用只读API密钥
• 审查 安全.md 用于全面的安全文档
• Claude Desktop在本地存储对话历史记录

贡献

欢迎捐款。确保代码遵循TypeScript的最佳实践，并包含正确的输入验证。

许可证

麻省理工学院

支持

• 检查故障排除部分
• 审查 安全.md
• 在GitHub上打开一个问题