MCP VoleyBall

Servidor MCP (Model Context Protocol) que proporciona acceso a datos de voleibol mediante consultas SQL. El proyecto incluye un proceso ETL para obtener datos de la API de VolleyballWorld y almacenarlos en una base de datos SQLite.

Descripcin

Este proyecto permite consultar datos de partidos, equipos y torneos de voleibol a travs de un servidor MCP. Los datos se obtienen desde la API de VolleyballWorld mediante un scraper, se convierten a formato SQLite y se exponen mediante un servidor MCP que permite ejecutar queries SQL.

Requisitos

• Python 3.11 o superior
• uv (gestor de paquetes) - Instalar uv

Instalacin

1. Clonar el repositorio:

git clone <url-del-repositorio>
cd MCP-VoleyBall

1. Instalar dependencias:

uv sync

Uso

1. Proceso ETL (Extraccin y carga de datos)

Primero necesitas obtener los datos de la API y convertirlos a base de datos SQLite:

1. Extraer datos de un torneo:

cd ETL
python scrapper.py

Por defecto, el scraper obtiene datos del torneo 1520 del ao 2025. Puedes modificar los parmetros en scrapper.py segn necesites.

1. Convertir JSON a SQLite:

python database_converter.py

Esto crear/actualizar el archivo volleyball_data.db en el directorio ETL/ con todos los datos estructurados.

2. Servidor MCP

Una vez que tengas la base de datos creada, puedes ejecutar el servidor MCP:

python main.py

Para desarrollo y pruebas del servidor MCP:

mcp dev main.py

O usando npx:

npx @modelcontextprotocol/inspector uv run main.py

El servidor MCP expone una herramienta execute_query que permite ejecutar queries SELECT en la base de datos de voleibol.

3. Visualizacin con Datasette

Para visualizar y explorar los datos de manera interactiva usando Datasette, ejecuta:

cd ETL
datasette serve volleyball_data.db

Esto iniciar un servidor web local (por defecto en http://127.0.0.1:8001) donde podrs explorar las tablas, ejecutar queries SQL y visualizar los datos de manera interactiva.

Configuracin del MCP Server en Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrega la siguiente configuracin en tu archivo de configuracin MCP (normalmente ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "voleyball-server": {
      "command": "/ruta/.venv/bin/python",
      "args": [
        "/ruta/main.py"
      ],
      "cwd": "/ruta/MCP-VoleyBall" 
    }
  }
}

Asegrate de usar la ruta absoluta al archivo main.py.

Estructura del Proyecto

MCP-VoleyBall/
 main.py                 # Servidor MCP
 db_connection.py        # Conexin a la base de datos
 ETL/
    scrapper.py         # Extraccin de datos de la API
    database_converter.py  # Conversin JSON a SQLite
    volleyball_data.db  # Base de datos (se genera con el ETL)
 pyproject.toml          # Dependencias del proyecto

Ejemplo de Queries

Una vez configurado el servidor MCP, puedes hacer consultas como:

'Que equipo gano mas partidos en el ano 2025'