Access and query volleyball data (matches, teams, tournaments) from the VolleyballWorld API through SQL queries executed via a Model Context Protocol (MCP) server.

Core Capabilities:

Execute SQL SELECT queries on a SQLite database containing volleyball statistics
Query match results and team statistics to answer questions like "Which team won the most matches in 2025?"
Access tournament information and analyze team performance across competitions
Integrate with Claude Desktop for AI-assisted natural language to SQL translation
Explore data interactively using Datasette web interface for visualization
Read-only access - only SELECT statements are supported for data retrieval

Data Source: VolleyballWorld API data extracted via ETL process and stored in volleyball_data.db

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.

Descripción

Este proyecto permite consultar datos de partidos, equipos y torneos de voleibol a través 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

Instalación

Clonar el repositorio:

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

Instalar dependencias:

uv sync

Uso

1. Proceso ETL (Extracción y carga de datos)

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

Extraer datos de un torneo:

cd ETL python scrapper.py

Por defecto, el scraper obtiene datos del torneo 1520 del año 2025. Puedes modificar los parámetros en scrapper.py según necesites.

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. Visualización 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 podrás explorar las tablas, ejecutar queries SQL y visualizar los datos de manera interactiva.

Configuración del MCP Server en Claude Desktop

Para usar este servidor MCP con Claude Desktop, agrega la siguiente configuración en tu archivo de configuración 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" } } }

Asegúrate de usar la ruta absoluta al archivo main.py.

Estructura del Proyecto

MCP-VoleyBall/ ├── main.py # Servidor MCP ├── db_connection.py # Conexión a la base de datos ├── ETL/ │ ├── scrapper.py # Extracción de datos de la API │ ├── database_converter.py # Conversión 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'

Volleyball MCP Server

MCP VoleyBall

Descripción

Requisitos

Instalación

Uso

1. Proceso ETL (Extracción y carga de datos)

2. Servidor MCP

3. Visualización con Datasette

Configuración del MCP Server en Claude Desktop

Estructura del Proyecto

Ejemplo de Queries

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API