Klaviyo MCP Server

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

## 功能

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

## 设置

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

### 网络钩子
- `get_webhooks`: 获取Klaviyo中的网络钩子
- `create_webhook`: 在Klaviyo中创建新的网络钩子
- `delete_webhook`: 删除Klaviyo中的网络钩子

### 数据隐私
- `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)。

</中文翻译>