Smartlead MCP 服务器

这是一个用于 Smartlead 活动管理集成的模型上下文协议 (MCP) 服务器。它提供了创建和管理活动、更新活动设置以及管理活动序列的工具。

功能

• 创建新活动
• 更新活动日程设置
• 更新活动常规设置
• 获取活动详情
• 列出所有活动，并提供筛选选项
• 保存活动邮件序列

安装

1. 克隆存储库
2. 安装依赖项：

npm install

3. 基于 .env.example 创建一个 .env 文件，并添加您的 Smartlead API 密钥：

SMARTLEAD_API_KEY=your_api_key_here

4. 构建项目：

npm run build

用法

独立用法

要直接启动服务器：

npm start

与 Claude 集成

要将此 MCP 服务器与 Claude 一起使用，您需要将其添加到 MCP 设置文件中：

1. 对于 Claude VSCode 扩展，将其添加到 c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
2. 对于 Claude 桌面应用程序，将其添加到 Windows 上的 %APPDATA%\Claude\claude_desktop_config.json

示例配置：

{
  "mcpServers": {
    "smartlead": {
      "command": "node",
      "args": ["E:/mcp-servers/smartlead/dist/index.js"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 your_api_key_here 替换为您实际的 Smartlead API 密钥。

配置

可以使用环境变量配置服务器：

• SMARTLEAD_API_KEY (必需): 您的 Smartlead API 密钥
• SMARTLEAD_API_URL (可选): 自定义 API URL (默认为 https://server.smartlead.ai/api/v1)
• SMARTLEAD_RETRY_MAX_ATTEMPTS: API 调用的最大重试次数 (默认: 3)
• SMARTLEAD_RETRY_INITIAL_DELAY: 重试的初始延迟（毫秒）(默认: 1000)
• SMARTLEAD_RETRY_MAX_DELAY: 重试的最大延迟（毫秒）(默认: 10000)
• SMARTLEAD_RETRY_BACKOFF_FACTOR: 重试延迟的回退因子 (默认: 2)

可用工具

smartlead_create_campaign

在 Smartlead 中创建一个新活动。

参数：

• name (必需): 活动名称
• client_id (可选): 活动的客户 ID

smartlead_update_campaign_schedule

更新活动的日程设置。

参数：

• campaign_id (必需): 要更新的活动的 ID
• timezone: 活动的时区 (例如, "America/Los_Angeles")
• days_of_the_week: 发送电子邮件的星期几 (1-7, 其中 1 是星期一)
• start_hour: 以 24 小时格式表示的开始时间 (例如, "09:00")
• end_hour: 以 24 小时格式表示的结束时间 (例如, "17:00")
• min_time_btw_emails: 电子邮件之间的最短时间（分钟）
• max_new_leads_per_day: 每天的最大新潜在客户数量
• schedule_start_time: 以 ISO 格式表示的计划开始时间

smartlead_update_campaign_settings

更新活动的常规设置。

参数：

• campaign_id (必需): 要更新的活动的 ID
• name: 活动的新名称
• status: 活动的状态 (active, paused, completed)
• settings: 其他活动设置

smartlead_get_campaign

按 ID 获取特定活动的详细信息。

参数：

• campaign_id (必需): 要检索的活动的 ID

smartlead_list_campaigns

列出所有活动，并提供可选的筛选。

参数：

• status: 按状态筛选活动 (active, paused, completed, all)
• limit: 要返回的最大活动数
• offset: 分页偏移量

smartlead_save_campaign_sequence

保存活动的电子邮件序列。

参数：

• campaign_id (必需): 活动的 ID
• sequence (必需): 电子邮件序列项的数组，每个项包含：
  • subject (必需): 电子邮件主题行
  • body (必需): 电子邮件正文内容
  • wait_days: 发送此电子邮件前等待的天数

许可证

MIT