MCP Partidos de Fútbol MCP Server

MCP Partidos de Fútbol ⚽

Un servidor MCP (Model Context Protocol) en Python para obtener datos de partidos de fútbol mediante web scraping inteligente desde múltiples fuentes.

🌟 Características

• 🏈 Múltiples fuentes: Extrae datos de ESPN, Goal.com, BBC Sport, Marca, AS y más
• 🔄 URLs configurables: Fácil modificación y adición de nuevas fuentes
• 📊 Salida JSON estructurada: Formato optimizado para procesamiento por IA
• 🚀 Compatible con MCP: Integración directa con Claude y otros sistemas de IA
• ⚡ Scraping asíncrono: Rendimiento optimizado con requests paralelos
• 🏆 Detección inteligente: Identifica automáticamente partidos "atractivos" y equipos grandes
• 🎯 Filtrado avanzado: Sistema de scoring para priorizar partidos importantes
• 💾 Sistema de caché: Evita requests innecesarios

📊 Datos que extrae

• Equipos: Nombres completos de equipos locales y visitantes
• Horarios: Fecha y hora exacta de los partidos
• Ligas: Competición, torneo o liga (Champions, Premier League, etc.)
• Canales: Canales de TV/streaming donde se transmite
• Estadios: Lugar donde se juega (cuando está disponible)
• Estado: Programado, en vivo, finalizado
• Marcadores: Resultados en tiempo real (cuando disponible)
• Nivel de atractivo: Score 1-5 basado en importancia de equipos y liga

🚀 Instalación rápida

Opción 1: Con uv (recomendado)

# Instalar uv si no lo tienes
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clonar e instalar
git clone <repo-url>
cd mcp-partidos
uv venv
uv pip install -r requirements.txt

Opción 2: Con pip tradicional

git clone <repo-url>
cd mcp-partidos
pip install -r requirements.txt

⚙️ Configuración

1. Configurar fuentes

Edita src/mcp_partidos/config.py para agregar o modificar fuentes:

FUENTES_PARTIDOS = [
    "https://www.espn.com/soccer/fixtures",
    "https://www.goal.com/fixtures", 
    "https://www.bbc.com/sport/football/fixtures",
    "https://www.marca.com/futbol/fixture.html",
    # Agrega más fuentes aquí
]

2. Configurar equipos importantes

Personaliza la lista de equipos "grandes" para el sistema de scoring:

EQUIPOS_GRANDES = [
    "Real Madrid", "Barcelona", "Manchester United", 
    "Liverpool", "Bayern Munich", "PSG",
    # Agrega más equipos aquí
]

🎮 Uso

Como servidor MCP (con Claude)

1. Configurar en claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-partidos": {
      "command": "uv",
      "args": ["run", "--directory", "/ruta/a/mcp-partidos", "python", "run_server.py"]
    }
  }
}

2. En Claude:

"Obtén los partidos de fútbol de hoy y muéstrame los 5 más atractivos ordenados por importancia"

Como script independiente

# Ejecutar servidor MCP
python run_server.py

# Probar el scraper
python test_scraper.py

# Probar una fuente específica
python test_scraper.py "https://www.espn.com/soccer/fixtures"

🛠️ Herramientas MCP disponibles

📋 Formato de salida JSON

{
  "partidos": [
    {
      "equipo_local": "Barcelona",
      "equipo_visitante": "Real Madrid", 
      "fecha": "2025-09-19",
      "hora": "15:00",
      "liga": "La Liga",
      "canales": ["ESPN", "Movistar+"],
      "estadio": "Camp Nou",
      "estado": "programado",
      "fuente": {
        "nombre": "espn.com",
        "url": "https://www.espn.com/soccer/fixtures"
      },
      "metadatos": {
        "es_partido_importante": true,
        "nivel_atractivo": 5,
        "fecha_extraccion": "2025-09-19T10:30:00Z"
      }
    }
  ],
  "fecha_consulta": "2025-09-19",
  "total_partidos": 15,
  "fuentes_consultadas": 6,
  "timestamp": "2025-09-19T10:30:00Z",
  "estadisticas": {
    "por_liga": {
      "Champions League": 4,
      "Premier League": 6,
      "La Liga": 5
    },
    "partidos_importantes": 8,
    "nivel_atractivo_promedio": 3.2
  }
}

🎯 Ejemplos de uso con Claude

# Partidos de hoy con análisis
"Obtén los partidos de fútbol de hoy, ordénalos por atractivo y dime cuáles son los 3 mejores para ver"

# Partidos por fecha
"¿Qué partidos hay el 2025-12-25? Muéstrame solo los de ligas europeas importantes"

# Análisis de fuentes
"Lista las fuentes configuradas y prueba ESPN para ver si funciona bien"

# Partidos por horario
"Obtén partidos de hoy y agrúpalos por franja horaria, mostrando horarios en UTC-5"

# Análisis por liga
"Dame partidos de hoy y dime cuántos hay por liga, priorizando Champions League"

🔧 D