Kayzen Analytics MCP サーバー
Kayzen Analytics APIと連携するためのモデルコンテキストプロトコル（MCP）サーバー実装。このパッケージにより、AIモデルは標準化されたインターフェースを介してKayzen広告キャンペーンデータにアクセスし、分析できるようになります。
特徴
自動認証: 自動更新メカニズムを備えた組み込みトークン管理
レポート管理: Kayzen分析レポートへの簡単なアクセス
エラー処理: APIインタラクションの包括的なエラー処理
TypeScript サポート: 型定義を備えた完全な TypeScript 実装
環境ベースの構成:環境変数を使用した簡単なセットアップ
Related MCP server: Deep Research MCP Server
インストール
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(文字列、必須): 取得するレポートのIDstart_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.0axios:^1.8.3dotenv:^16.4.7zod:^3.24.2
エラー処理
サーバーはさまざまなエラー シナリオを処理します。
認証失敗
無効なAPIリクエスト
ネットワークの問題
トークンの有効期限と更新
無効なパラメータ
ライセンス
MITライセンス
著者
フィードモブ
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.