drip MCP

MCP办公协作

提供方 ctrlswing

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

Drip MCP Server是一个模型上下文协议服务器,用于管理电子邮件营销平台的订阅者、活动、标签、事件和工作流。

一句话选型结论

按资料字段整理

drip MCP 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 16 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量16暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

电子邮件营销Python本地部署订阅者管理自动化工作流标签管理事件跟踪

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python scripts/install_helper.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 16 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 16 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
drip MCP当前 16 stdio · 本地进程 支持远程部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ctrlswing上游标注的维护方 ctrlswing
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.8 KB
来自项目仓库与上游目录的原文,未做删改

滴注MCP服务器

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

特性

核心能力

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

智能功能

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

安装

先决条件

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

快速安装

我们提供安装帮助脚本,使安装更容易:

选项1:Python安装助手(推荐)```bash

python scripts/install_helper.py


#### 选项2:Bash安装脚本```bash
chmod +x scripts/install.sh
./scripts/install.sh

选项3:手动安装

第一步:克隆或下载```bash

Save the files to your desired directory

mkdir ~/drip-mcp
cd ~/drip-mcp


### 步骤2:安装依赖项```bash
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:设置环境变量```bash

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:测试服务器```bash
# 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 或同等):```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脚本用法```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.导入和标记订阅者```python
# 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.跟踪客户旅程```python

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.细分和活动管理```python
# 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
  • 或者克隆并在本地安装:```bash
    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` 调整响应大小限制:```python
CHARACTER_LIMIT = 50000  # Increase for larger responses

自定义用户代理

修改 get_auth_headers() 函数用于设置自定义用户代理:python "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配置以指向新的服务器路径。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
drip MCP 怎么安装?

在客户端按下面的安装命令接入:python scripts/install_helper.py。装完在客户端配置里引用同一个包或端点。

drip MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

drip MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

drip MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

drip MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

drip MCP 能提供哪些能力?

资料显示约 16 个工具;能力标签包括 标签管理、Python、Claude。具体工具清单以官方文档为准。

drip MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

drip MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。