Klaviyo MCP Server

Klaviyo MCP 服务

一个功能全面的模型上下文协议（MCP）服务，用于与 Klaviyo API 交互。此服务提供工具和资源，可在 Klaviyo 中管理个人资料、列表、细分、营销活动、流程等。

## 功能

- 完整覆盖 Klaviyo API 端点
- 为所有主要 Klaviyo 操作提供 MCP 工具
- 提供用于访问 Klaviyo 数据的 MCP 资源
- 通过模型上下文协议轻松与大模型集成

## 设置

1. 克隆此仓库
2. 安装依赖：
   ```
   npm install
   ```
3. 根据 `.env.example` 创建 `.env` 文件，并添加 Klaviyo API 密钥：
   ```
   KLAVIYO_API_KEY=your_private_api_key_here
   ```
4. 启动服务：
   ```
   npm run dev
   ```

## 使用 MCP Inspector 测试

你可以使用 MCP Inspector 测试此服务：

```
npm run inspect
```

这将打开一个 Web 界面，你可以在其中测试所有可用工具和资源。

## 可用工具

### 个人资料
- `get_profiles`：获取 Klaviyo 中的个人资料
- `get_profile`：获取 Klaviyo 中的指定个人资料
- `create_profile`：在 Klaviyo 中创建新的个人资料
- `update_profile`：更新 Klaviyo 中已有的个人资料
- `delete_profile`：从 Klaviyo 中删除个人资料

### 列表
- `get_lists`：获取 Klaviyo 中的列表
- `get_list`：获取 Klaviyo 中的指定列表
- `create_list`：在 Klaviyo 中创建新列表
- `add_profiles_to_list`：将个人资料添加到 Klaviyo 中的列表

### 细分
- `get_segments`：获取 Klaviyo 中的细分
- `get_segment`：获取 Klaviyo 中的指定细分

### 事件
- `get_events`：获取 Klaviyo 中的事件
- `create_event`：在 Klaviyo 中创建新事件

### 指标
- `get_metrics`：获取 Klaviyo 中的指标
- `get_metric`：获取 Klaviyo 中的指定指标

### 营销活动
- `get_campaigns`：获取 Klaviyo 中的营销活动
- `get_campaign`：获取 Klaviyo 中的指定营销活动

### 流程
- `get_flows`：获取 Klaviyo 中的流程
- `get_flow`：获取 Klaviyo 中的指定流程
- `update_flow_status`：更新 Klaviyo 中某个流程的状态

### 模板
- `get_templates`：获取 Klaviyo 中的模板
- `get_template`：获取 Klaviyo 中的指定模板
- `create_template`：在 Klaviyo 中创建新模板

### 目录
- `get_catalogs`：获取 Klaviyo 中的目录
- `get_catalog_items`：获取 Klaviyo 目录中的商品
- `get_catalog_item`：获取 Klaviyo 目录中的指定商品

### 标签
- `get_tags`：获取 Klaviyo 中的标签
- `create_tag`：在 Klaviyo 中创建新标签
- `add_tag_to_resource`：为 Klaviyo 中的资源添加标签

### Webhook
- `get_webhooks`：获取 Klaviyo 中的 Webhook
- `create_webhook`：在 Klaviyo 中创建新的 Webhook
- `delete_webhook`：从 Klaviyo 中删除 Webhook

### 数据隐私
- `request_profile_deletion`：请求删除个人资料，以满足数据隐私合规要求

### 优惠券
- `get_coupons`：获取 Klaviyo 中的优惠券
- `create_coupon_code`：在 Klaviyo 中创建新的优惠券代码

### 表单
- `get_forms`：获取 Klaviyo 中的表单
- `get_form`：获取 Klaviyo 中的指定表单

### 评论
- `get_product_reviews`：获取 Klaviyo 中的商品评论
- `get_product_review`：获取 Klaviyo 中的指定商品评论

### 图片
- `get_images`：获取 Klaviyo 中的图片
- `get_image`：获取 Klaviyo 中的指定图片

## 可用资源
- `klaviyo://profile/{id}`：获取特定个人资料的信息
- `klaviyo://list/{id}`：获取特定列表的信息
- `klaviyo://segment/{id}`：获取特定细分的信息
- `klaviyo://campaign/{id}`：获取特定营销活动的信息
- `klaviyo://flow/{id}`：获取特定流程的信息
- `klaviyo://template/{id}`：获取特定模板的信息
- `klaviyo://metric/{id}`：获取特定指标的信息
- `klaviyo://catalog/{id}`：获取特定目录的信息

## API 文档

如需了解有关 Klaviyo API 的更多信息，请参阅[官方文档](https://developers.klaviyo.com/en/reference/api_overview)。