drip MCP

滴注MCP服务器

模型上下文协议（MCP）服务器，使Claude Code和其他MCP客户端能够与Drip的电子邮件营销平台进行交互。此服务器为管理订阅者、活动、标签、事件和工作流提供了全面的工具。

特性

核心能力

• 用户管理：创建、更新、列出、获取和取消订阅订阅者
• 标签管理：应用和删除标签以进行细分
• 事件追踪：记录行为触发器的自定义事件
• 活动管理：列出活动，订阅/取消订阅电子邮件系列用户
• 工作流程自动化：列出、激活、暂停工作流，并启动工作流上的订阅者
• 批量操作：高效处理批量订阅者更新
• 自定义字段：列出和管理自定义字段标识符

智能功能

• 双响应格式：所有工具都支持JSON（用于处理）和Markdown（用于可读性）
• 分页支持：通过内置分页功能高效处理大型数据集
• 字符限制保护：自动响应截断，提供有用的指导
• 全面的错误处理：清晰、可操作的错误消息
• GDPR合规性：内置对欧盟同意管理的支持

安装

先决条件

• Python 3.8或更高版本
• 具有API访问权限的滴水帐户
• MCP兼容客户端（如Claude Code）

快速安装

我们提供安装帮助脚本，使安装更容易：

选项1:Python安装助手（推荐）

python scripts/install_helper.py

选项2:Bash安装脚本

chmod +x scripts/install.sh
./scripts/install.sh

选项3：手动安装

第一步：克隆或下载

# Save the files to your desired directory
mkdir ~/drip-mcp
cd ~/drip-mcp

步骤2：安装依赖项

pip install httpx pydantic

# Install MCP SDK (try one of these methods):
pip install mcp

# If that doesn't work, try from GitHub:
pip install git+https://github.com/modelcontextprotocol/python-sdk.git

# Or clone and install locally:
git clone https://github.com/modelcontextprotocol/python-sdk.git
cd python-sdk
pip install -e .
cd ..

步骤3：设置环境变量

# Get these from your Drip account
export DRIP_API_KEY='your-api-key-here'
export DRIP_ACCOUNT_ID='your-account-id-here'

查找您的凭据：

• API密钥：滴水仪表板→ 设置→ 我的用户设置→ API代币
• 账户ID：查看您的Drip仪表板URL（URL中的数字）

步骤4：测试服务器

# Test that the server starts correctly
python -m drip_mcp.server --help

# Or run the test script
python tests/test_server.py

使用Claude代码

配置Claude代码

将以下内容添加到您的Claude Code配置文件中(~/.config/claude/claude_config.json 或同等）：

{
  "mcpServers": {
    "drip": {
      "command": "python",
      "args": ["-m", "drip_mcp.server"],
      "cwd": "/absolute/path/to/drip_mcp",
      "env": {
        "DRIP_API_KEY": "your-api-key",
        "DRIP_ACCOUNT_ID": "your-account-id",
        "PYTHONPATH": "/absolute/path/to/drip_mcp/src"
      }
    }
  }
}

看 docs/claude_code_config_example.json 以获得完整的配置示例。

Claude代码中的示例命令

配置后，您可以使用自然语言与Drip进行交互：

// Subscriber Management
"Add john@example.com to Drip with the tag 'Customer'"
"List all active subscribers"
"Show me details for jane@example.com"
"Unsubscribe user@example.com from all emails"

// Tag Management
"Apply the 'VIP' tag to customer@example.com"
"Show me all tags in my Drip account"
"Remove the 'Trial' tag from user@example.com"

// Event Tracking
"Record a 'Started Trial' event for new@example.com"
"Track a purchase of $99.99 for customer@example.com"
"List all custom events we're tracking"

// Campaign Management
"List all active email campaigns"
"Subscribe lead@example.com to campaign 123456"
"Remove subscriber@example.com from all campaigns"

// Workflow Automation
"Show me all workflows"
"Activate workflow 789012"
"Start john@example.com on the onboarding workflow"

// Batch Operations
"Import these 50 subscribers from a CSV"
"Update tags for multiple subscribers at once"

可用工具

用户管理

• drip_create_update_subscriber -创建或更新订阅者
• drip_list_subscribers -列出具有筛选功能的订阅者
• drip_fetch_subscriber -获取详细的订阅者信息
• drip_unsubscribe_from_all -全球取消订阅
• drip_batch_subscribe -批量创建/更新多达1000个订阅者

标签管理

• drip_list_tags -列出帐户中的所有标签
• drip_apply_tag -为订阅者添加标签
• drip_remove_tag -从订阅者中删除标签

事件追踪

• drip_record_event -为订阅者记录自定义事件
• drip_list_event_actions -列出正在跟踪的所有事件类型

活动管理

• drip_list_campaigns -列出电子邮件系列活动
• drip_subscribe_to_campaign -为某人订阅活动
• drip_unsubscribe_from_campaign -从活动中删除

工作流管理

• drip_list_workflows -列出所有工作流
• drip_activate_workflow -激活工作流
• drip_pause_workflow -暂停工作流
• drip_start_on_workflow -在工作流中启动订阅者

实用工具

• drip_list_custom_fields -列出自定义字段标识符

刀具参数

大多数工具支持以下常见参数：

响应格式

• response_format：在“markdown”（人类可读）或“json”（机器可读）之间进行选择

分页

• page：页码（从1开始）
• per_page：每页结果（最多100个）

过滤

• status：按订阅者/活动状态筛选
• tags：按标签筛选（逗号分隔）
• sort：按不同字段对结果进行排序

示例

Python脚本用法

import asyncio
import sys
sys.path.insert(0, 'src')  # Add src to path

from drip_mcp import create_update_subscriber, SubscriberCreateUpdateInput

async def main():
    # Create a subscriber
    params = SubscriberCreateUpdateInput(
        email="newuser@example.com",
        first_name="John",
        last_name="Doe",
        tags=["Customer", "Newsletter"],
        custom_fields={"company": "Acme Corp"},
        response_format="markdown"
    )
    result = await create_update_subscriber(params)
    print(result)

asyncio.run(main())

常见工作流

1.导入和标记订阅者

# Batch import with tags
subscribers = [
    {"email": "user1@example.com", "tags": ["Import-Jan-2024"]},
    {"email": "user2@example.com", "tags": ["Import-Jan-2024", "VIP"]}
]
await batch_subscribe(subscribers)

2.跟踪客户旅程

# Record multiple events for a subscriber
await record_event({
    "email": "customer@example.com",
    "action": "Viewed Product",
    "properties": {"product_id": "SKU123", "category": "Electronics"}
})

await record_event({
    "email": "customer@example.com",
    "action": "Made Purchase",
    "properties": {"value": 9999}  # $99.99 in cents
})

3.细分和活动管理

# Apply tags and subscribe to campaign
await apply_tag({"email": "lead@example.com", "tag": "Interested-In-Demo"})
await subscribe_to_campaign({
    "campaign_id": "123456",
    "email": "lead@example.com",
    "double_optin": True
})

错误处理

服务器为常见问题提供明确的错误消息：

• 缺少凭据：如果未设置环境变量，则发出警告
• API错误：从Drip API返回详细的错误消息
• 速率限制：处理Drip的速率限制（50个批处理请求/小时，3600个个人/小时）
• 验证错误：Pydantic在API调用之前验证所有输入

最佳实践

1. 使用批处理操作：对于多个订阅者，请使用 drip_batch_subscribe 而不是单独通话
2. 尊重率限制：50批请求/小时，3600个单独请求/小时
3. 使用标签进行细分标签在触发自动化方面具有强大的功能
4. 使用属性跟踪事件：在事件属性中包含相关数据
5. 选择适当的响应格式：使用JSON进行处理，使用Markdown进行阅读
6. 处理分页：对大型结果集使用页面参数

故障排除

服务器无法启动

• 检查Python版本： python --version （需要3.8+）
• 验证依赖关系： pip list | grep -E "mcp|httpx|pydantic"
• 检查环境变量： echo $DRIP_API_KEY

导入错误：FastMCP

如果你看到 ImportError: cannot import name 'FastMCP':

• MCP SDK可能安装不正确
• 尝试从GitHub安装： pip install git+https://github.com/modelcontextprotocol/python-sdk.git
• 或者克隆并在本地安装：

  git clone https://github.com/modelcontextprotocol/python-sdk.git
  cd python-sdk
  pip install -e .

身份验证错误

• 验证API密钥是否正确且处于活动状态
• 检查帐户ID是否与您的Drip帐户匹配
• 确保API密钥具有必要的权限

连接问题

• 检查互联网连接
• 验证滴水API是否可访问： curl https://api.getdrip.com/v2/accounts
• 检查代理/防火墙限制

高级配置

自定义字符限制

编辑 CHARACTER_LIMIT 常数in src/drip_mcp/server.py 调整响应大小限制：

CHARACTER_LIMIT = 50000  # Increase for larger responses

自定义用户代理

修改 get_auth_headers() 函数用于设置自定义用户代理：

"User-Agent": "YourApp/1.0 (Drip MCP Server)"

安全说明

• 永远不要提交API密钥：使用环境变量或安全密钥管理
• 验证输入：服务器使用Pydantic进行输入验证
• 仅限HTTPS：所有API通信都使用HTTPS
• 范围有限：工具设计有适当的读/写提示

支持和资源

• 滴注API文件: https://developer.drip.com/
• MCP规范: https://modelcontextprotocol.io/
• 滴水帮助中心: https://help.drip.com/

许可证

此MCP服务器按原样提供，供Drip的API使用。确保您遵守Drip的API服务条款和费率限制。

贡献

为了促进改进：

1. 使用滴水测试帐户彻底更改测试
2. 遵循MCP工具设计最佳实践
3. 更新新功能的文档
4. 确保向后兼容性

版本历史

• 1.0.1 -代码库重构和改进

- 重组项目：组织成 src/, tests/, scripts/，以及 docs/ 目录 - 删除不必要的文件：删除不正确 package.json 和 pnpm-lock.yaml - 添加 pyproject.toml：具有适当依赖关系的现代Python打包 - 更新进口：主模块现在位于 src/drip_mcp/server.py - 修复了与FastMCP的兼容性（删除了不支持的注释参数） - 添加了安装助手脚本 - 改进了MCP SDK安装的错误处理 - 增强 .gitignore 具有全面的Python模式 - 重大变更：服务器路径已更改-更新Claude Code配置以使用 python -m drip_mcp.server

• 1.0.0 -具有核心滴水功能的初始版本

- 用户管理 - 活动和工作流工具 - 标签和事件跟踪 - 批量操作支持

项目结构说明

从v1.0.1开始，该项目遵循Python的最佳实践，采用分层结构。主源代码在 src/drip_mcp/，测试 tests/，公用事业 scripts/，以及文档 docs/。如果从v1.0.0升级，请更新您的Claude Code配置以指向新的服务器路径。