Klaviyo MCP 服务器

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

## 功能

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

## 设置

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 中的资源

### Webhooks
- `get_webhooks`: 从 Klaviyo 获取 Webhooks
- `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)。