Klaviyo API MCP Server

Klaviyo API MCP Server

Klaviyo API と連携するための包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、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
```

ウェブインターフェースが開き、次の操作ができます：
- 利用可能なツールとリソースを確認する
- さまざまな入力でツールをテストする
- サーバーのログと応答を確認する

## 利用可能なツール

### プロファイル
- `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