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

用法

基本设置

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 (string, 可选): 开始日期，格式为 YYYY-MM-DD
  • end_date (string, 可选): 结束日期，格式为 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 (Prompt)

分析报告结果并提供见解。

• 输入:
  • 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 凭据

脚本

# 安装依赖项
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 请求
• 网络问题
• 令牌过期和刷新
• 无效参数

许可证

MIT 许可证

作者

FeedMob