Servidor MCP de Kayzen Analytics

Implementación de servidor del Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Kayzen Analytics. Este paquete permite que los modelos de IA accedan y analicen los datos de las campañas publicitarias de Kayzen mediante una interfaz estandarizada.

Características

Autenticación automatizada : gestión de tokens integrada con mecanismo de actualización automática
Gestión de informes : Fácil acceso a los informes analíticos de Kayzen
Manejo de errores : manejo integral de errores para interacciones de API
Compatibilidad con TypeScript : implementación completa de TypeScript con definiciones de tipos
Configuración basada en el entorno : configuración sencilla mediante variables de entorno

Instalación

npm install @feedmob-ai/kayzen-mcp

Configuración

Crea un archivo .env con tus credenciales de Kayzen:

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

Uso

Configuración básica

import { KayzenMCPServer } from '@feedmob-ai/kayzen-mcp';

const server = new KayzenMCPServer();
server.start();

Herramientas disponibles

1. `list_reports`

Enumera todos los informes disponibles de Kayzen Analytics.

Entradas : Ninguna
Devuelve : Matriz de objetos de informe que contiene:
- id : Identificador del informe
- name : Nombre del informe
- type : Tipo de informe

const reports = await server.tools.list_reports();

2. `get_report_results`

Recupera resultados para un informe específico.

Entradas :
- report_id (cadena, obligatoria): ID del informe a obtener
- start_date (cadena, opcional): Fecha de inicio en formato AAAA-MM-DD
- end_date (cadena, opcional): Fecha de finalización en formato AAAA-MM-DD
Devuelve : Datos y metadatos del informe

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` (Indicación)

Analiza los resultados del informe y proporciona información.

Entradas :
- report_id (cadena): ID del informe a analizar
El análisis incluye :
- Métricas de rendimiento
- Tendencias clave
- Áreas de optimización
- Patrones o anomalías inusuales

Configuración

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su 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"
      }
    }
  }
}

Desarrollo

Prerrequisitos

Node.js (v16 o superior)
npm (v7 o superior)
Credenciales de la API de Kayzen

Guiones

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Development mode with hot-reload
npm run dev

Estructura del proyecto

kayzen-mcp/
├── src/
│   ├── server.ts        # MCP server implementation
│   └── kayzen-client.ts # Kayzen API client
├── dist/               # Compiled JavaScript
└── package.json       # Project configuration

Dependencias

Dependencias principales:

@modelcontextprotocol/sdk : ^1.7.0
axios : ^1.8.3
dotenv : ^16.4.7
zod : ^3.24.2

Manejo de errores

El servidor gestiona varios escenarios de error:

Errores de autenticación
Solicitudes de API no válidas
Problemas de red
Vencimiento y actualización del token
Parámetros no válidos

Licencia

Licencia MIT

Autor

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.

Una implementación que permite que los modelos de IA accedan y analicen los datos de las campañas publicitarias de Kayzen a través de una interfaz estandarizada con funciones como autenticación automatizada y gestión de informes.

Related MCP Servers

Audiense Insights MCP Serverofficial
AudienseCo
A
security
A
license
A
quality
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Last updated -
8
6
14
TypeScript
Apache 2.0
Deep Research MCP Server
Ozamatash
-
security
A
license
-
quality
Enables iterative deep research by integrating AI agents with search engines, web scraping, and large language models for efficient data gathering and comprehensive reporting.
Last updated -
9
249
TypeScript
MIT License
Ads Manager MCP Server
amekala
-
security
F
license
-
quality
Enables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.
Last updated -
4
JavaScript
Plausible MCP Server
AVIMBU
-
security
F
license
-
quality
Allows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.
Last updated -
TypeScript

View all related MCP servers

Kayzen Analytics MCP Server