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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

该实现使 AI 模型能够通过标准化界面访问和分析 Kayzen 广告活动数据，并具有自动身份验证和报告管理等功能。

Related MCP Servers

SEO AI Assistant
ccnn2509
-
security
F
license
-
quality
Provides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.
Last updated -
4
JavaScript
Google Ads MCP
cohnen
-
security
A
license
-
quality
A tool that connects Google Ads with Claude AI, allowing users to analyze advertising data through natural language conversations and access campaign information, performance metrics, keyword analytics, and ad management.
Last updated -
60
Python
MIT License
SEO AI Assistant
ayushsinghvi92
-
security
F
license
-
quality
MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
Last updated -
Korea Tourism API MCP Server
harimkang
-
security
A
license
-
quality
Enables AI assistants to access South Korean tourism information via the official Korea Tourism Organization API, providing comprehensive search for attractions, events, food, and accommodations with multilingual support.
Last updated -
5
Python
MIT License

View all related MCP servers

Kayzen Analytics MCP Server