Kayzen Analytics MCP 服务器
用于与 Kayzen Analytics API 交互的模型上下文协议 (MCP) 服务器实现。该软件包使 AI 模型能够通过标准化接口访问和分析 Kayzen 广告活动数据。
特征
自动身份验证：内置令牌管理，具有自动刷新机制
报告管理：轻松访问 Kayzen 分析报告
错误处理：API 交互的全面错误处理
TypeScript 支持：具有类型定义的完整 TypeScript 实现
基于环境的配置：使用环境变量进行简单设置
Related MCP server: Deep Research MCP Server
安装
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（字符串，必需）：要获取的报告的 IDstart_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.0axios：^1.8.3dotenv：^16.4.7zod：^3.24.2
错误处理
服务器处理各种错误情况：
身份验证失败
无效的 API 请求
网络问题
令牌过期和刷新
参数无效
执照
MIT 许可证
作者
FeedMob
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.