Kiniela Game Prediction Tool¶

KinielaGPT es un servidor MCP (Model Context Protocol) diseñado para potenciar tus predicciones de la Quiniela mediante un análisis avanzado de datos. Combina las probabilidades oficiales de LAE con un análisis contextual profundo: histórico de enfrentamientos, rachas recientes, clasificación y rendimiento como local o visitante. Ofrece tres estrategias de predicción, detección de sorpresas y un análisis pormenorizado partido a partido.

🎯 Características Principales¶

🎲 Predicción de Resultados

Genera pronósticos mediante tres estrategias: conservadora, arriesgada o totalmente personalizada.
📊 Análisis Integral de Partidos

Integra probabilidades de LAE, histórico de duelos, rachas, clasificación y contexto para ofrecer una predicción razonada.
🔍 Detección de Sorpresas

Detecta discrepancias entre las probabilidades oficiales y el rendimiento real (rachas, histórico, forma) para anticipar posibles sorpresas.
👥 Estado de Forma de Equipos

Evalúa el rendimiento detallado: últimos marcadores, rachas vigentes, desempeño local/visitante y tendencias clasificatorias.
📈 Consulta Flexible de Datos

Accede tanto a análisis interpretados como a los datos en bruto para sacar tus propias conclusiones.
🔌 Servidor MCP Nativo

Incluye 7 herramientas especializadas, totalmente compatibles con Claude Desktop, VS Code y otros clientes MCP.

🏁 Pasos para empezar a usar KinielaGPT¶

Sigue estos pasos para tener KinielaGPT listo y funcionando en tu equipo:

Instala UV o Python 3.10+ en tu PC.
Instala KinielaGPT.
Configura el servidor MCP, eligiendo Claude o VS Code como cliente.

Una vez completados estos pasos, ¡ya puedes empezar a hacer predicciones y análisis con KinielaGPT!

⚡ Instalar UV o Python¶

Antes de usar KinielaGPT necesitaras tener instalado UV (recomendado) o Python 3.10+.

A continuación se muestran como instalar las dos opciones, aunque debes elegir una de las dos:

Opción 1: UV (Recomendado)¶

UV es un gestor de paquetes y proyectos Python ultrarrápido que simplifica la instalación y ejecución de herramientas Python. No requiere tener Python pre-instalado.

🪟 Instalar UV en Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verificar:

uv --version

🍎🐧 Instalar UV en macOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Verificar:

uv --version

Advertencia

Reinicia tu terminal después de la instalación.

Opción 2: Python 3.10+ y pip¶

Si ya tienes Python instalado y prefieres el método tradicional, puedes usar pip (el gestor de paquetes de Python). Requiere tener Python 3.10 o superior ya instalado en tu sistema.

🪟 Instalar Python en Windows

Descarga Python 3.10+ desde python.org/downloads
Marca “Add Python to PATH” durante la instalación
Verifica:

python --version
pip --version

🍎 Instalar Python en macOS

macOS:

Ve a python.org/downloads
Descarga Python 3.10+ para macOS
Ejecuta el instalador . pkg

Verifica:

python3 --version
pip3 --version

🐧 Instalar Python Linux (Ubuntu/Debian)

sudo apt update
sudo apt install python3.10 python3-pip python3.10-venv

Verifica:

python3 --version
pip3 --version

🚀 Instalación¶

Opción 1: Usando UV (recomendado)¶

Con UV instalado, no necesitas instalar KinielaGPT. Usarás uvx para ejecutarlo directamente (ver Configuración).

Opción 2: Usando pip¶

Instala KinielaGPT desde PyPI:

pip install kinielagpt

🔧 Configuración¶

🤖 Configurar para Claude.app¶

Edita el archivo de configuración claude_desktop_config.json que según tu sistema operativo se encuentra en:

Windows: %APPDATA%\Roaming\Claude\claude_desktop_config.json
macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

Añade una de las siguientes configuraciones según tu método de instalación:

Usando uvx

{
  "mcpServers": {
    "kinielagpt": {
      "command": "uvx",
      "args": ["kinielagpt"]
    }
  }
}

Usando pip

{
  "mcpServers": {
    "kinielagpt": {
      "command": "python",
      "args": ["-m", "kinielagpt"]
    }
  }
}

Nota

En macOS/Linux, si python no funciona, usa python3 en su lugar.

💻 Configurar para VS Code¶

Abre la Paleta de Comandos (Ctrl + Shift + P), ejecuta MCP: Open User Configuration y añade una de las siguientes configuraciones:

Usando uvx

{
  "mcpServers": {
    "kinielagpt": {
      "command": "uvx",
      "args": ["kinielagpt"]
    }
  }
}

Usando pip

{
  "mcpServers": {
    "kinielagpt": {
      "command": "python",
      "args": ["-m", "kinielagpt"]
    }
  }
}

Nota

En macOS/Linux, si python no funciona, usa python3 en su lugar.

Truco

Como alternativa puedes crear el archivo .vscode/mcp.json en tu workspace para compartir la configuración con otros. Más detalles en la documentación oficial de VS Code MCP.

📖 ¿Cómo usar KinielaGPT?¶

Una vez configurado el MCP, puedes interactuar con tu LLM (Claude, GPT, Gemini, etc.) en lenguaje natural. Simplemente hazle preguntas como las siguientes:

Categoría	Ejemplos de Preguntas
Consultas de información	🔹 “¿Cuál es la última quiniela disponible?” 🔹 “Muéstrame los partidos de la jornada 26 de la temporada 2025/2026” 🔹 “¿Qué probabilidades tiene cada partido de la jornada actual?”
Predicciones de quiniela	🔹 “Dame una predicción conservadora para la jornada actual” 🔹 “Quiero una predicción arriesgada para la próxima jornada” 🔹 “Genera una quiniela personalizada con 7 unos, 4 equis y 4 doses”
Análisis de partidos	🔹 “Analiza el partido qye jugará el Real Madrid esta jornada” 🔹 “¿Qué pasará en el partido Villarreal - Getafe?” 🔹 “Muéstrame el histórico de enfrentamientos del partido Alavés - Real Sociedad”
Detección de sorpresas	🔹 “¿Hay algún partido donde pueda haber sorpresa en esta jornada?” 🔹 “Detecta sorpresas con un umbral más sensible (threshold=20)”
Análisis de equipos	🔹 “¿Cómo está jugando el Rayo Vallecano últimamente?” 🔹 “Analiza el rendimiento del Barcelona actualmente” 🔹 “¿Qué racha tiene el Atletico de Madrid actualmente?”

⚽ Proyecto creado por Ricardo Moya para que cada quiniela se juegue con cabeza, estrategia y datos.

🐙 GitHub: @RicardoMoya
💼 LinkedIn: Ricardo Moya, PhD