Kayzen Analytics MCP サーバー

Kayzen Analytics APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー実装。このパッケージにより、AIモデルは標準化されたインターフェースを介してKayzen広告キャンペーンデータにアクセスし、分析できるようになります。

特徴

自動認証: 自動更新メカニズムを備えた組み込みトークン管理
レポート管理: Kayzen分析レポートへの簡単なアクセス
エラー処理: APIインタラクションの包括的なエラー処理
TypeScript サポート: 型定義を備えた完全な TypeScript 実装
環境ベースの構成:環境変数を使用した簡単なセットアップ

インストール

npm install @feedmob-ai/kayzen-mcp

構成

Kayzen の資格情報を使用して.envファイルを作成します。

KAYZEN_USERNAME=your_username
KAYZEN_PASSWORD=your_password
KAYZEN_BASIC_AUTH=your_basic_auth_token
KAYZEN_BASE_URL=https://api.kayzen.io/v1  # Optional, defaults to this value

使用法

基本設定

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',  // optional
  end_date: '2024-01-31'     // optional
});

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": "auth token"
      }
    }
  }
}

発達

前提条件

Node.js (v16 以上)
npm (v7以上)
Kayzen API 認証情報

スクリプト

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Development mode with hot-reload
npm run dev

プロジェクト構造

kayzen-mcp/
├── src/
│   ├── server.ts        # MCP server implementation
│   └── kayzen-client.ts # Kayzen API client
├── dist/               # Compiled JavaScript
└── package.json       # Project configuration

依存関係

主な依存関係:

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

エラー処理

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

認証失敗
無効なAPIリクエスト
ネットワークの問題
トークンの有効期限と更新
無効なパラメータ

ライセンス

MITライセンス

著者

フィードモブ

Kayzen Analytics MCP Server

Integrations

Kayzen Analytics MCP サーバー

特徴

インストール

構成

使用法

基本設定

利用可能なツール

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` (プロンプト)

設定

Claude Desktopでの使用

NPX

発達

前提条件

スクリプト

プロジェクト構造

依存関係

エラー処理

ライセンス

著者

Integrations

Kayzen Analytics MCP サーバー

特徴

インストール

構成

使用法

基本設定

利用可能なツール

1. list_reports

2. get_report_results

3. analyze_report_results (プロンプト)

設定

Claude Desktopでの使用

NPX

発達

前提条件

スクリプト

プロジェクト構造

依存関係

エラー処理

ライセンス

著者

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` (プロンプト)