AI导哈

广告数据分析服务

Kayzen Analytics MCP Server是一个用于与Kayzen Analytics API交互的模型上下文协议服务器实现，使AI模型能够通过标准化接口访问和分析Kayzen广告活动数据。

  • by springwq
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 springwq/kayzen-mcp

使用说明

Kayzen分析MCP服务器

用于与Kayzen Analytics API交互的模型上下文协议（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  # 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 （string，必填）：要获取的报告的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 （string）：要分析的报告的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许可证

作者

FeedMob

相关 MCP