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  # 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 （字符串，必需）：要获取的报告的 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 （字符串）：要分析的报告的 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

Kayzen Analytics MCP Server

Integrations

Kayzen Analytics MCP 服务器

特征

安装

配置

用法

基本设置

可用工具

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` （提示）

设置

与 Claude Desktop 一起使用

NPX

发展

先决条件

脚本

项目结构

依赖项

错误处理

执照

作者

Integrations

Kayzen Analytics MCP 服务器

特征

安装

配置

用法

基本设置

可用工具

1. list_reports

2. get_report_results

3. analyze_report_results （提示）

设置

与 Claude Desktop 一起使用

NPX

发展

先决条件

脚本

项目结构

依赖项

错误处理

执照

作者

1. `list_reports`

2. `get_report_results`

3. `analyze_report_results` （提示）