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ライセンス

著者

フィードモブ

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

自動認証やレポート管理などの機能を備えた標準化されたインターフェースを通じて、AI モデルが Kayzen 広告キャンペーンデータにアクセスして分析できるようにする実装。

Related MCP Servers

Audiense Insights MCP Serverofficial
AudienseCo
A
security
A
license
A
quality
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Last updated -
8
6
14
TypeScript
Apache 2.0
Deep Research MCP Server
Ozamatash
-
security
A
license
-
quality
Enables iterative deep research by integrating AI agents with search engines, web scraping, and large language models for efficient data gathering and comprehensive reporting.
Last updated -
9
249
TypeScript
MIT License
Ads Manager MCP Server
amekala
-
security
F
license
-
quality
Enables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.
Last updated -
4
JavaScript
Plausible MCP Server
AVIMBU
-
security
F
license
-
quality
Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
Last updated -
TypeScript

View all related MCP servers

Kayzen Analytics MCP Server