Kayzen Analytics MCP Server

基本能力

产品定位

Kayzen Analytics MCP Server 是一个用于与 Kayzen Analytics API 交互的 MCP 服务器实现，主要用于广告数据分析。

核心功能

• 自动化认证：内置令牌管理，具有自动刷新机制
• 报告管理：轻松访问 Kayzen 分析报告
• 错误处理：全面的 API 交互错误处理
• TypeScript 支持：完整的 TypeScript 实现，包含类型定义
• 基于环境的配置：使用环境变量进行简单设置

适用场景

• 广告活动数据分析
• 广告效果评估
• 广告优化建议生成

工具列表

1. list_reports
2. 能力：列出 Kayzen Analytics 中所有可用的报告
3. 输入：无

4. 返回：包含报告 ID、名称和类型的报告对象数组

5. get_report_results

6. 能力：获取特定报告的结果
7. 输入：
   • report_id（字符串，必需）：要获取的报告 ID
   • start_date（字符串，可选）：开始日期（YYYY-MM-DD 格式）
   • end_date（字符串，可选）：结束日期（YYYY-MM-DD 格式）

8. 返回：报告数据和元数据

9. analyze_report_results (Prompt)

10. 能力：分析报告结果并提供见解
11. 输入：report_id（字符串）：要分析的报告 ID
12. 分析内容：
    • 性能指标
    • 关键趋势
    • 优化领域
    • 异常模式

常见问题解答

• 认证失败：检查 .env 文件中的 Kayzen 凭据是否正确
• 无效 API 请求：确保请求参数符合 API 文档要求
• 网络问题：检查网络连接和 API 端点 URL
• 令牌过期：服务器会自动刷新令牌

使用教程

使用依赖

• Node.js（v16 或更高版本）
• npm（v7 或更高版本）
• Kayzen API 凭据

安装教程

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  # 可选，默认为此值

调试方式

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 开发模式（热重载）
npm run dev

许可证

该项目遵循 MIT 开源许可条款。