Kayzen Analytics

🚀 Kayzen Analytics MCP 服務器

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 請求
• 網絡問題
• 令牌自動刷新