Pitágoras MCP Server

Un servidor MCP (Model Context Protocol) para integrar datos de campañas de marketing digital desde Pitágoras API, permitiendo análisis interactivos a través de interfaces como Claude Desktop.

Características

- Conexión a la API de Pitágoras para obtener datos de:
- Google Ads
- Facebook Ads
- Google Analytics 4

Instalación

Sigue las instrucciones de la guía de instalación

Integración con Claude Desktop

Una vez configurado el servidor MCP, puedes:

1. Conectarte a través de Claude Desktop
2. Seleccionar un cliente
3. Elegir las cuentas y medios para análisis
4. Realizar consultas sobre rendimiento de campañas
5. Generar dashboards, gráficos, análisis y reportes

Estructura del proyecto

.
├── CLAUDE.md
├── README.md
├── initial_prompt.md
├── main.py
├── pitagoras
│   ├── __init__.py
│   ├── api.py
│   ├── config.py
│   └── models.py
├── pyproject.toml
├── requirements.txt
└── server
    ├── __init__.py
    ├── prompts.py
    ├── resources.py
    ├── tools.py
    └── utils.py

Changelog

v0.3.0

- Nueva funcionalidad: Agregado soporte para filtros personalizados en Google Analytics 4 - Nuevas herramientas: Implementadas herramientas de metadata para acceder a esquemas e información de atributos - Mejoras en API: Expandido el wrapper de API con funciones de recuperación de metadata - Documentación: Actualizada documentación de uso de filtros personalizados en prompts - Configuración: Actualizados endpoints de API con nuevas funcionalidades de metadata - Calidad de código: Corregidas importaciones no utilizadas y manejo de excepciones

v0.2.2

- Mejoras en prompts: Refinados los prompts para prohibir explícitamente la estimación de datos - UX: Mejoradas las instrucciones para reintentar extracción cuando no se pueden recuperar datos de la API

v0.2.1

- Corrección: Solucionado error que impedía realizar consultas a Google Analytics 4

v0.2.0

- Nueva integración: Agregada integración con Google Analytics 4 - Estructura: Mejoras en la estructura del proyecto - Dependencias: Actualización de dependencias

v0.1.0

- Versión inicial: Implementación base del servidor MCP - Soporte inicial: Google Ads y Facebook Ads - Protocolo: Implementación del protocolo MCP básico

v0.2.1

- Corrección: Solucionado error que impedía realizar consultas a Google Analytics 4

v0.2.0

- Agregada integración con Google Analytics 4 - Mejoras en la estructura del proyecto - Actualización de dependencias

v0.1.0

- Versión inicial - Soporte para Google Ads y Facebook Ads - Implementación del protocolo MCP básico