AI导哈

邮件营销工具服务器

EmailBison MCP是一个独立的邮件营销工具服务器，支持Windows、macOS和Linux系统，无需Python环境，可直接与Claude Desktop集成，提供邮件营销活动管理、回复分析、潜在客户管理等功能。

  • by Sirkunle001
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Sirkunle001/email-bison-claude-mcp

使用说明

EmailBison MCP（单文件应用程序）

单机 MCP服务器 对于EmailBison，打包为单个二进制文件 Windows/macOS/Linux.
不需要Python。第一次运行时，它可以 提示 为您的API密钥和基础URL创建一个本地 .env.

主控程序 （模型上下文协议）让桌面AI应用程序——比如 Claude桌面版--调用外部工具。
此应用程序向Claude公开EmailBison工具（活动、回复、潜在客户、预热、事件等）。

✅ 开始之前（必填）

  1. 安装克劳德桌面
    从Anthropic下载并安装您的操作系统：

    • 克劳德桌面（macOS/Windows）: https://www.anthropic.com/claude/desktop
      打开它一次以完成设置，然后退出它——接下来我们将连接MCP服务器。

  2. 拥有EmailBison API密钥
    建议使用每个工作区密钥。把它放在手边。

🚀 快速入门（大多数用户）

  1. 下载 从回购 发布 页面：

    • 视窗→ emailbison-mcp-windows.exe
    • macOS→ emailbison-mcp-macos
    • Linux→ emailbison-mcp-linux

  2. 一次性安装到Claude中（推荐）
    跑 一次 随着 --install-claude 在Claude的配置中自动注册此MCP服务器（备份文件并安全合并），然后退出。

    • Windows（PowerShell）
      .\emailbison-mcp-windows.exe --install-claude
    • macOS
      chmod +x ./emailbison-mcp-macos
./emailbison-mcp-macos --install-claude
    • Linux
      chmod +x ./emailbison-mcp-linux
./emailbison-mcp-linux --install-claude

  3. 正常运行服务器

    • Windows：双击 emailbison-mcp-windows.exe
    • macOS/Linux：
      ./emailbison-mcp-macos     # or: ./emailbison-mcp-linux

  4. 首次运行提示（可选）
    如果不存在env变量，则该应用程序提供创建一个 .env 二进制文件旁边:

    • EMAILBISON_API_KEY （隐藏输入）
    • EMAILBISON_BASE_URL （默认值： https://send.highticket.agency)
      按 进入 跳过字段。如果输入值，它们将立即保存并使用。

更喜欢手动设置？创建一个 .env 在应用程序旁边：

EMAILBISON_API_KEY=sk_live_...
EMAILBISON_BASE_URL=https://send.highticket.agency
  1. 打开/重新启动Claude桌面
    在步骤2之后（或手动配置之后），重新启动Claude Desktop。
    你应该看看 电子邮件。 可用作工具源。

🧭 在Claude Desktop中使用它

服务器运行时，尝试以下提示：

  • “列出活动”
  • “分析活动12345 （包括回复和顺序）”
  • “分析活动12345的回复”
  • “创建名为Q4 Outbound的活动”
  • “将潜在客户[101102103]添加到活动12345（允许并行发送）”
  • “停止在活动中为潜在客户[201202]发送未来的电子邮件12345”
  • “列出预热帐户” → “启用发件人ID[5,6]的预热”
  • “原始请求GET/api/用过滤器回复…“（调试）

🔧 包含的内容（工具）

  • 活动： list_campaigns, analyze_campaign, campaign_performance_summary
  • 答复： analyze_replies, dump_replies_json （调试）
  • 引导： lead_engagement_analysis, add_leads_to_campaign, stop_future_emails
  • 顺序： sequence_optimization_insights
  • 活动： campaign_events_stats
  • 电子邮件帐户/预热： list_email_accounts, list_warmup_accounts, warmup_account_details, warmup_enable, warmup_disable, warmup_update_limits
  • 调试： raw_request （任何HTTP方法+路径+参数/body）

服务器在控制台中打印简洁的HTTP诊断（重试、422详细信息、JSON/HTML安全）。

🧩 手动Claude配置（仅当跳过时 --install-claude)

Claude配置位置：

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

添加/合并：

{
  "mcpServers": {
    "emailbison": {
      "command": "/absolute/path/to/emailbison-mcp-macos"
      /* Optional if not using .env:
      ,"env": {
        "EMAILBISON_API_KEY": "sk_live_...",
        "EMAILBISON_BASE_URL": "https://send.highticket.agency"
      }
      */
    }
  }
}

Windows示例：

"command": "C:\\Users\\YOU\\Downloads\\emailbison-mcp-windows.exe"

编辑后重新启动Claude Desktop。

🆘 故障排除

  • 首先，确保已安装Claude Desktop。
    运行前安装 --install-claude 或者启动服务器。

  • 克劳德没有看到工具

    • 确保 服务器应用程序正在运行 （让窗户开着）。
    • 如果你使用 --install-claude, 重新启动克劳德桌面 之后。
    • 在手动配置中，确认 绝对路径 二进制是正确的。

  • 未经授权/丢失钥匙
    放一个 .env 在应用程序旁边或设置系统环境变量，然后重新启动。

  • macOS“无法打开”（身份不明的开发人员）
    控件单击→ 打开一次，或：

    xattr -d com.apple.quarantine ./emailbison-mcp-macos

  • 422/API错误
    控制台显示前~2KB的错误正文+JSON字段。
    使用 raw_request 快速探测精确的终点/参数。

🗑 卸载

没有安装程序，只需删除文件：

  1. 关闭服务器窗口。
  2. 删除二进制文件(emailbison-mcp-*).
  3. 删除本地 .env 旁边（如果存在）。
  4. 删除您创建的任何快捷方式/符号链接。

🔐 安全和多个工作区

  • 对待你的 API密钥 就像密码一样。
  • 对于多个EmailBison工作区，请执行以下任一操作：
    • 保持单独的文件夹，每个文件夹都有自己的 .env, 或
    • 在Claude的配置中添加多个条目，每个条目都有自己的 env 块。
  • 定期旋转关键点。

🧱 构建自己的二进制文件（维护者）

  • 窗户：
    双击 build_windows.bat （生产 dist/emailbison-mcp.exe)
  • macOS/Linux：
    chmod +x build_macos.sh build_linux.sh
./build_macos.sh     # or: ./build_linux.sh

产出土地 dist/.

CI（可选）：GitHub Release自动构建

如果你已经添加了提供的GitHub Actions工作流，请推送一个标签（例如。， v0.3.0)构建二进制文件并将其附加到版本。

📄 许可证和支持

  • 许可证：MIT（或您选择的许可证）
  • 问题：请包括操作系统、采取的步骤和控制台输出的最后约30行（删除机密）

常见问题解答

我需要Python吗？
不是的。二进制文件包含了所有内容。

我应该使用哪个基本URL？
通常 https://send.highticket.agency 除非您的EmailBison实例不同。

我可以在后台运行它吗？
是的，高级用户可以作为服务运行（Linux上的systemd，Windows上的任务计划程序），但大多数用户在使用Claude时只是让窗口保持打开状态。

相关 MCP