Klaviyo API MCP Server

Klaviyo API MCP 服务

一个功能全面的 Model Context Protocol（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`：获取目录中的指定项目
- `create_catalog_item`：在目录中创建新项目
- `update_catalog_item`：更新目录中的现有项目
- `delete_catalog_item`：从目录中删除项目

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

## 可用资源
- `klaviyo://docs/{section}`：不同 API 部分的文档
  - 可用部分：overview、profiles、lists、events、campaigns、flows、segments、metrics、templates、catalogs、data-privacy

## 许可证

MIT