Skip to main content
Glama
Sign In
enesjakozh

cfbd-mcp-server

by lenwood
GitHub
Python
MIT License
8
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Mentions College Football Data's Patreon subscription option that provides higher rate limits for API access, enabling more frequent queries for comprehensive college football statistics.

Servidor MCP de datos de fútbol universitario

Una implementación de servidor MCP que proporciona acceso a estadísticas de fútbol universitario obtenidas de la API de datos de fútbol universitario dentro de Claude Desktop .

Descripción general

Este servidor de Protocolo de Contexto de Modelo (MCP) permite que los asistentes y aplicaciones de IA:

  • Consulta estadísticas y datos completos del fútbol universitario
  • Acceda a resultados de juegos, récords de equipos y estadísticas de jugadores.
  • Analizar datos jugada por jugada y generar resúmenes
  • Ver clasificaciones y métricas de probabilidad de victoria
  • Comparar el rendimiento del equipo y generar información

Los usuarios pueden ejecutar consultas utilizando lenguaje natural.

Salida de muestra

P. ¿Cuál fue la mayor sorpresa entre los juegos de la FCS durante la temporada 2014?

A. Permítame ayudarle a encontrar la mayor sorpresa de la FCS de 2014. Revisaré los datos de los juegos, centrándome en los juegos entre equipos de la FCS donde hubo una brecha significativa en la fuerza del equipo y un resultado inesperado.

Los datos sugieren que hubo varias sorpresas notables en la FCS durante 2014, pero una que destaca fue la victoria de Eastern Washington sobre Washington por 52-59 el 6 de septiembre de 2014. Esto fue particularmente significativo porque:

  1. Washington fue un equipo de FBS de la conferencia Pac-12
  2. El partido se jugó en el estadio local de Washington (Husky Stadium).
  3. La probabilidad de victoria de Eastern Washington era solo del 1,4% según las estadísticas posteriores al partido.
  4. Los 59 puntos que anotó Eastern Washington fueron la mayor cantidad jamás obtenida por un equipo de la FCS contra un oponente de la Pac-12.
  5. Washington había sido favorito por múltiples puntajes al comenzar el juego.

Otras sorpresas notables de la FCS de esa temporada incluyeron:

  • El estado de Dakota del Norte derrotó al estado de Iowa por 34-14
  • Bethune-Cookman derrota a FIU 14-12
  • Northern Iowa casi sorprende a Iowa (perdió 31-23)

Sin embargo, la victoria de Eastern Washington sobre Washington parece ser la mayor sorpresa de la temporada 2014 de la FCS si consideramos:

  • La diferencia en divisiones (FCS vs FBS)
  • El calibre del oponente de la FBS (conferencia Power 5)
  • El margen de puntuación y el rendimiento ofensivo del equipo desfavorecido
  • La importancia histórica como una de las victorias de la FCS con mayor puntuación sobre un equipo Power 5
  • El hecho de que ocurriera en la carretera en un ambiente hostil.

Prerrequisitos

Instalación

Instalación mediante herrería

Para instalar College Football Data Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install cfbd --client claude
  1. Clonar este repositorio:
git clone https://github.com/yourusername/cfbd-mcp-server cd cfbd-mcp-server
  1. Crear y activar un entorno virtual:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  1. Instalar dependencias:
uv pip install -e .
  1. Cree un archivo .env en la raíz del proyecto y agregue su clave API:
CFB_API_KEY=your_api_key_here

Instalación manual

  1. Clonar este repositorio:
git clone https://github.com/yourusername/cfbd-mcp-server cd cfbd-mcp-server
  1. Crear y activar un entorno virtual:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  1. Instalar dependencias:
uv pip install -e .
  1. Cree un archivo .env en la raíz del proyecto y agregue su clave API:
CFB_API_KEY=your_api_key_here

Uso

Ejecución del servidor

Iniciar el servidor:

uv run cfbd-mcp-server

Conectando con Claude Desktop

  1. Abra la configuración de Claude Desktop en:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
  2. Agregue la configuración del servidor:
{ "mcpServers": { "cfbd-mcp-server": { "command": "uv", "args": [ "--directory", "/full/path/to/cfbd-mcp-server", "run", "cfbd-mcp-server" ], "env": { "CFB_API_KEY": "xxx", "PATH": "/full/path/to/python" } } } }
  1. Cierre y reinicie Claude Desktop

Al reiniciar, debería ver un pequeño icono de martillo en la esquina inferior derecha del cuadro de texto. Si pasa el cursor sobre él, verá la cantidad de herramientas MCP disponibles.

Actualización después de la instalación

  1. Descargar los archivos actualizados
cd cfbd-mcp-server git pull
  1. Desinstalar el paquete existente:
uv pip uninstall cfbd-mcp-server
  1. Eliminar artefactos de compilación y metadatos existentes

Para Windows:

rmdir /s /q build dist del /s /q *.egg-info

Para macOS:

rm -rf build dist *.egg-info
  1. Instalar el paquete revisado y sus dependencias
uv pip install -e . uv sync --dev --all-extras
uv run cfbd-mcp-server
  1. Cerrar y reiniciar Claude Desktop

Características

Recursos

Acceda a la documentación del esquema para todos los puntos finales:

  • schema://games - Información y puntuaciones de los juegos
  • schema://records - Récords de la temporada del equipo
  • schema://games/teams - Datos detallados de los juegos de equipo
  • schema://plays - Información jugada por jugada
  • schema://drives - Resúmenes y resultados de las unidades
  • schema://play/stats - Estadísticas de juego individuales
  • schema://rankings - Clasificaciones de equipos en las encuestas
  • schema://metrics/wp/pregame - Probabilidades de victoria antes del juego
  • schema://game/box/advanced - Estadísticas avanzadas de puntuación de caja

Herramientas

Consultar puntos finales directamente:

  • get-games - Recuperar datos del juego
  • get-records - Obtener los récords del equipo
  • get-games-teams - Accede a las estadísticas de juego del equipo
  • get-plays - Consultar datos jugada por jugada
  • get-drives - Analizar la información de la unidad
  • get-play-stats - Ver estadísticas de juego
  • get-rankings - Consultar la clasificación del equipo
  • get-pregame-win-probability : ver probabilidades de victoria
  • get-advanced-box-score : accede a estadísticas y análisis detallados del juego

Indicaciones

Plantillas de análisis prediseñadas:

  • analyze-game - Obtén un análisis detallado de un juego específico
  • analyze-team : análisis completo de un solo equipo
  • analyze-trends - Analizar tendencias a lo largo de una temporada
  • compare-teams - Comparar el rendimiento de dos equipos
  • analyze-rivalry - Analizar enfrentamientos históricos de rivalidades

Límites de la API

La API de datos de fútbol universitario es de uso gratuito, pero tiene un límite de velocidad:

  • Nivel gratuito: solicitudes limitadas por minuto
  • Los suscriptores de Patreon de CFBD obtienen límites de tarifa más altos
  • Utilice patrones de consulta eficientes para evitar alcanzar los límites
  • Manejar errores de límite de velocidad con elegancia

Desarrollo

Estructura del proyecto

cfbd-mcp-server/ ├── README.md ├── pyproject.toml └── src/ └── cfbd_mcp_server/ ├── .env ├── __init__.py ├── cfbd_schema.py ├── schema_helpers.py └── server.py

Preparándose para el desarrollo

  1. Clonar el repositorio
  2. Instalar dependencias de desarrollo:
uv pip install -e ".[dev]"
  1. Ejecutar pruebas:
pytest

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear una rama de características
  3. Confirme sus cambios
  4. Empuja hacia tu tenedor
  5. Enviar una solicitud de extracción

Solución de problemas

Problemas comunes

  1. Errores de clave API
    • Verifique que su clave API esté configurada correctamente en los archivos .env y claude_desktop_config.json
    • Compruebe que la clave sea válida en collegefootballdata.com
  2. Limitación de velocidad
    • Espaciar las solicitudes cuando sea posible
    • Considere la suscripción a Patreon para límites más altos
    • Implementar el almacenamiento en caché para datos a los que se accede con frecuencia
  3. Problemas de conexión
    • Verificar la conectividad a Internet
    • Consulte el estado de la API en collegefootballdata.com
    • Asegúrese de que el manejo de errores sea adecuado en su código

Obtener ayuda

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Un servidor MCP que proporciona acceso a estadísticas de fútbol universitario provenientes de la API de datos de fútbol universitario dentro de Claude Desktop.

  1. Overview
    1. Sample output
      1. Prerequisites
        1. Installation
          1. Installing via Smithery
          2. Manual Installation
        2. Usage
          1. Running the Server
          2. Connecting with Claude Desktop
        3. Updating after install
          1. Features
            1. Resources
            2. Tools
            3. Prompts
          2. API Limits
            1. Development
              1. Project Structure
              2. Setting Up for Development
              3. Contributing
            2. Troubleshooting
              1. Common Issues
              2. Getting Help
            3. License
              1. Acknowledgments

                Appeared in Searches

                ID: ggh4skfx4o