Volleyball MCP Server

Instructions

Ejecuta una query SQL en la base de datos de voleibol.

Args:
    query: La query SQL a ejecutar.

Returns:
    Una lista de tuplas con los resultados de la query.

Implementation Reference

• main.py:8-20 (handler)

  The execute_query tool handler, registered via @mcp.tool() decorator. Thin wrapper around run_query helper.

  @mcp.tool()
  def execute_query(query: str, ctx: Context) -> list:
      """
      Ejecuta una query SQL en la base de datos de voleibol.
  
      Args:
          query: La query SQL a ejecutar.
  
      Returns:
          Una lista de tuplas con los resultados de la query.
      """
      rows = run_query(query)
      return rows

• db_connection.py:25-45 (helper)

  Core helper function that executes the SQL query safely (SELECT only) using sqlite3 and returns results.

  def run_query(sql: str, params: Tuple[Any, ...] = ()) -> List[Tuple]:
      """Ejecuta una query SELECT y devuelve los resultados.
      
      Args:
          sql: La query SQL a ejecutar.
          params: Los parámetros para la query.
  
      Returns:
          Una lista de tuplas con los resultados de la query.
      """
      if not sql.strip().lower().startswith("select"):
          raise ValueError("Solo se permiten queries SELECT. Intenta con una query SELECT.")
      
      conn = get_connection()
      try:
          cur = conn.cursor()
          cur.execute(sql, params)
          return cur.fetchall()
      finally:
          conn.close()