Kayzen Analytics

🚀 Kayzen Analytics MCP サーバー

Kayzen Analytics API とやり取りする Model Context Protocol (MCP) サーバーの実装です。このパッケージにより、AI モデルは標準インターフェースを通じて Kayzen 広告キャンペーンデータにアクセスし、分析することができます。

✨ 主な機能

• 自動認証：自動更新機能付きの組み込みトークン管理
• レポート管理：Kayzen 分析レポートへの簡単なアクセス
• エラー処理：API とのやり取りにおける包括的なエラー処理
• TypeScript サポート：完全な TypeScript 実装と型定義
• 環境に基づく設定：環境変数を使用した簡単な設定

📦 インストール

npm install @feedmob-ai/kayzen-mcp

📚 ドキュメント

設定

.env ファイルを作成し、Kayzen の資格情報を入力します。

KAYZEN_USERNAME=your_username
KAYZEN_PASSWORD=your_password
KAYZEN_BASIC_AUTH=your_basic_auth_token
KAYZEN_BASE_URL=https://api.kayzen.io/v1  # オプション、デフォルトはこの値

使用方法

基本的な使用法

import { KayzenMCPServer } from '@feedmob-ai/kayzen-mcp';

const server = new KayzenMCPServer();
server.start();

提供されているツール

1. list_reports

Kayzen Analytics で利用可能なすべてのレポートをリストします。

• 入力：なし
• 戻り値：以下の内容を含むレポートオブジェクトの配列
  • id：レポート識別子
  • name：レポート名
  • type：レポートタイプ

const reports = await server.tools.list_reports();

2. get_report_results

特定のレポートの結果を取得します。

• 入力：
  • report_id (文字列、必須)：取得するレポートの ID
  • start_date (文字列、オプション)：開始日、形式は YYYY-MM-DD
  • end_date (文字列、オプション)：終了日、形式は YYYY-MM-DD
• 戻り値：レポートデータとメタデータ

const results = await server.tools.get_report_results({
  report_id: 'report_id',
  start_date: '2024-01-01',  // オプション
  end_date: '2024-01-31'     // オプション
});

3. analyze_report_results（ヒント）

レポート結果を分析し、洞察を提供します。

• 入力：
  • report_id (文字列)：分析するレポートの ID
• 分析内容：
  • パフォーマンス指標
  • 主要なトレンド
  • 最適化の領域
  • 異常パターンまたは異常

Claude Desktop での使用

Claude Desktop で使用するには、claude_desktop_config.json に以下の内容を追加します。

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@feedmob-ai/kayzen-mcp"
      ],
      "env": {
        "KAYZEN_USERNAME": "username",
        "KAYZEN_PASSWORD": "pasword",
        "KAYZEN_BASIC_AUTH": "認証トークン"
      }
    }
  }
}

開発

前提条件

• Node.js (v16 以上)
• npm (v7 以上)
• Kayzen API 資格情報

スクリプト

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

# 開発モード（ホットリロード付き）
npm run dev

プロジェクト構造

kayzen-mcp/
├── src/
│   ├── server.ts        # MCP サーバー実装
│   └── kayzen-client.ts # Kayzen API クライアント
├── dist/               # コンパイルされた JavaScript
└── package.json       # プロジェクト設定

依存関係

主な依存関係：

• @modelcontextprotocol/sdk：^1.7.0
• axios：^1.8.3
• dotenv：^16.4.7
• zod：^3.24.2

エラー処理

サーバーはさまざまなエラーシナリオを処理します。

• 認証失敗
• 無効な API リクエスト
• ネットワーク問題
• トークンの自動更新