Klaviyo API MCP 服务器

这是一个全面的模型上下文协议（MCP）服务器，用于与 Klaviyo 的 API 进行交互。该服务器提供了管理 Klaviyo 中的用户资料、列表、事件、活动、流程、模板、分段、指标、目录和数据隐私的工具和资源。

## 功能

- 完整覆盖 Klaviyo 的 API 功能
- 使用 Zod 进行适当的验证的结构化工具
- 提供 API 参考文档资源
- 错误处理和日志记录

## 设置

1. 克隆此仓库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建一个包含你的 Klaviyo API 密钥的 `.env` 文件：
   ```
   KLAVIYO_API_KEY=your_private_api_key_here
   ```
4. 启动服务器：
   ```
   npm run dev
   ```

## 使用 MCP Inspector 测试

您可以使用 MCP Inspector 来测试服务器：

```
npm run inspect
```

这将打开一个 Web 界面，在这里您可以：
- 浏览可用的工具和资源
- 使用不同的输入测试工具
- 查看服务器日志和响应

## 可用工具

### 用户资料
- `get_profiles`: 获取用户资料列表，可选过滤
- `get_profile`: 根据 ID 获取特定用户资料
- `create_profile`: 创建新的用户资料
- `update_profile`: 更新现有用户资料
- `delete_profile`: 删除用户资料

### 列表
- `get_lists`: 获取所有列表
- `get_list`: 根据 ID 获取特定列表
- `create_list`: 创建新的列表
- `update_list`: 更新现有列表
- `delete_list`: 删除列表
- `get_list_profiles`: 获取列表中的用户资料
- `add_profiles_to_list`: 将用户资料添加到列表中
- `remove_profiles_from_list`: 从列表中移除用户资料

### 事件
- `get_events`: 获取事件列表，可选过滤
- `get_event`: 根据 ID 获取特定事件
- `create_event`: 创建新的事件

### 活动
- `get_campaigns`: 获取活动列表，可选过滤
- `get_campaign`: 根据 ID 获取特定活动
- `create_campaign`: 创建新的活动
- `update_campaign`: 更新现有活动
- `delete_campaign`: 删除活动
- `send_campaign`: 发送活动

### 流程
- `get_flows`: 获取流程列表，可选过滤
- `get_flow`: 根据 ID 获取特定流程
- `update_flow_status`: 更新流程状态

### 模板
- `get_templates`: 获取模板列表，可选过滤
- `get_template`: 根据 ID 获取特定模板
- `create_template`: 创建新的模板
- `update_template`: 更新现有模板
- `delete_template`: 删除模板
- `clone_template`: 复制现有模板
- `render_template`: 使用上下文变量渲染模板

### 分段
- `get_segments`: 获取分段列表，可选过滤
- `get_segment`: 根据 ID 获取特定分段

### 指标
- `get_metrics`: 获取指标列表，可选过滤
- `get_metric`: 根据 ID 获取特定指标

• get_metric_aggregate: 获取指标的聚合数据 - get_metric_timeline: 获取指标的时间线数据

### 目录

- `get_catalogs`: 获取目录列表
- `get_catalog`: 根据 ID 获取特定目录
- `get_catalog_items`: 获取目录中的项目
- `get_catalog_item`: 根据 ID 获取特定目录中的项目
- `create_catalog_item`: 在目录中创建新项目
- `update_catalog_item`: 更新目录中的现有项目
- `delete_catalog_item`: 从目录中删除项目

### 数据隐私
- `create_deletion_request`: 创建新的数据删除请求
- `get_deletion_requests`: 获取数据删除请求列表
- `get_deletion_request`: 根据 ID 获取特定的数据删除请求

## 可用资源

- `klaviyo://docs/{section}`: 不同 API 部分的文档
  - 可用部分：概述、用户资料、列表、事件、活动、流程、分段、指标、模板、目录、数据隐私

## 许可证

MIT